Get Target
GET/v2beta/actions/targets/:id
Returns the target identified by the requested ID.
Required permission:
action.target.read
Required feature flag:
actions
Request​
Path Parameters
Responses​
- 200
- 400
- 403
- 404
- default
Target retrieved successfully
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
target
object
The unique identifier of the target.
The timestamp of the target creation.
The timestamp of the last change to the target (e.g. creation, activation, deactivation).
restWebhook
object
Define if any error stops the whole execution. By default the process continues as normal.
restCall
object
Define if any error stops the whole execution. By default the process continues as normal.
Timeout defines the duration until ZITADEL cancels the execution.
If the target doesn't respond before this timeout expires, the the connection is closed and the action fails. Depending on the target type and possible setting on interrupt_on_error
following targets will not be called. In case of a rest_async
target only this specific target will fail, without any influence on other targets of the same execution.
{
"target": {
"id": "69629012906488334",
"creationDate": "2024-12-18T07:50:47.492Z",
"changeDate": "2025-01-23T10:34:18.051Z",
"name": "ip_allow_list",
"restWebhook": {
"interruptOnError": true
},
"restCall": {
"interruptOnError": true
},
"restAsync": {},
"timeout": "10s",
"endpoint": "https://example.com/hooks/ip_check",
"signingKey": "98KmsU67"
}
}
- Schema
- Example (from schema)
Schema
target
object
The unique identifier of the target.
The timestamp of the target creation.
The timestamp of the last change to the target (e.g. creation, activation, deactivation).
restWebhook
object
Define if any error stops the whole execution. By default the process continues as normal.
restCall
object
Define if any error stops the whole execution. By default the process continues as normal.
Timeout defines the duration until ZITADEL cancels the execution.
If the target doesn't respond before this timeout expires, the the connection is closed and the action fails. Depending on the target type and possible setting on interrupt_on_error
following targets will not be called. In case of a rest_async
target only this specific target will fail, without any influence on other targets of the same execution.
{
"target": {
"id": "69629012906488334",
"creationDate": "2024-12-18T07:50:47.492Z",
"changeDate": "2025-01-23T10:34:18.051Z",
"name": "ip_allow_list",
"restWebhook": {
"interruptOnError": true
},
"restCall": {
"interruptOnError": true
},
"restAsync": {},
"timeout": "10s",
"endpoint": "https://example.com/hooks/ip_check",
"signingKey": "98KmsU67"
}
}
- Schema
- Example (from schema)
Schema
target
object
The unique identifier of the target.
The timestamp of the target creation.
The timestamp of the last change to the target (e.g. creation, activation, deactivation).
restWebhook
object
Define if any error stops the whole execution. By default the process continues as normal.
restCall
object
Define if any error stops the whole execution. By default the process continues as normal.
Timeout defines the duration until ZITADEL cancels the execution.
If the target doesn't respond before this timeout expires, the the connection is closed and the action fails. Depending on the target type and possible setting on interrupt_on_error
following targets will not be called. In case of a rest_async
target only this specific target will fail, without any influence on other targets of the same execution.
{
"target": {
"id": "69629012906488334",
"creationDate": "2024-12-18T07:50:47.492Z",
"changeDate": "2025-01-23T10:34:18.051Z",
"name": "ip_allow_list",
"restWebhook": {
"interruptOnError": true
},
"restCall": {
"interruptOnError": true
},
"restAsync": {},
"timeout": "10s",
"endpoint": "https://example.com/hooks/ip_check",
"signingKey": "98KmsU67"
}
}
The feature flag actions
is not enabled.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
Schema
any
- Schema
Schema
any
- Schema
Schema
any
Returned when the user does not have permission to access the resource.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
The target to update does not exist.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
Schema
any
- Schema
Schema
any
- Schema
Schema
any
An unexpected error response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}