Target by ID
GET/resources/v3alpha/actions/targets/:id
Returns the target identified by the requested ID.
Request​
Path Parameters
Query Parameters
Responses​
- 200
- 403
- 404
- default
Target successfully retrieved
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
target
object
details
object
the timestamp of the first event applied to the object.
the timestamp of the last event applied to the object.
owner
object
the parent object representing the returned objects context.
Possible values: [OWNER_TYPE_UNSPECIFIED
, OWNER_TYPE_SYSTEM
, OWNER_TYPE_INSTANCE
, OWNER_TYPE_ORG
]
Default value: OWNER_TYPE_UNSPECIFIED
config
object
Possible values: non-empty
and <= 1000 characters
restWebhook
object
Wait for response but response body is ignored, status is checked, call is sent as post.
Define if any error stops the whole execution. By default the process continues as normal.
restCall
object
Wait for response and response body is used, status is checked, call is sent as post.
Define if any error stops the whole execution. By default the process continues as normal.
Call is executed in parallel to others, ZITADEL does not wait until the call is finished. The state is ignored, call is sent as post.
if the target doesn't respond before this timeout expires, the the connection is closed and the action fails
Possible values: non-empty
and <= 1000 characters
{
"target": {
"details": {
"id": "69629012906488334",
"created": "2024-12-20T16:04:44.512Z",
"changed": "2024-12-20T16:04:44.512Z",
"owner": "69629023906488334"
},
"config": {
"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
details
object
the timestamp of the first event applied to the object.
the timestamp of the last event applied to the object.
owner
object
the parent object representing the returned objects context.
Possible values: [OWNER_TYPE_UNSPECIFIED
, OWNER_TYPE_SYSTEM
, OWNER_TYPE_INSTANCE
, OWNER_TYPE_ORG
]
Default value: OWNER_TYPE_UNSPECIFIED
config
object
Possible values: non-empty
and <= 1000 characters
restWebhook
object
Wait for response but response body is ignored, status is checked, call is sent as post.
Define if any error stops the whole execution. By default the process continues as normal.
restCall
object
Wait for response and response body is used, status is checked, call is sent as post.
Define if any error stops the whole execution. By default the process continues as normal.
Call is executed in parallel to others, ZITADEL does not wait until the call is finished. The state is ignored, call is sent as post.
if the target doesn't respond before this timeout expires, the the connection is closed and the action fails
Possible values: non-empty
and <= 1000 characters
{
"target": {
"details": {
"id": "69629012906488334",
"created": "2024-12-20T16:04:44.513Z",
"changed": "2024-12-20T16:04:44.513Z",
"owner": "69629023906488334"
},
"config": {
"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
details
object
the timestamp of the first event applied to the object.
the timestamp of the last event applied to the object.
owner
object
the parent object representing the returned objects context.
Possible values: [OWNER_TYPE_UNSPECIFIED
, OWNER_TYPE_SYSTEM
, OWNER_TYPE_INSTANCE
, OWNER_TYPE_ORG
]
Default value: OWNER_TYPE_UNSPECIFIED
config
object
Possible values: non-empty
and <= 1000 characters
restWebhook
object
Wait for response but response body is ignored, status is checked, call is sent as post.
Define if any error stops the whole execution. By default the process continues as normal.
restCall
object
Wait for response and response body is used, status is checked, call is sent as post.
Define if any error stops the whole execution. By default the process continues as normal.
Call is executed in parallel to others, ZITADEL does not wait until the call is finished. The state is ignored, call is sent as post.
if the target doesn't respond before this timeout expires, the the connection is closed and the action fails
Possible values: non-empty
and <= 1000 characters
{
"target": {
"details": {
"id": "69629012906488334",
"created": "2024-12-20T16:04:44.514Z",
"changed": "2024-12-20T16:04:44.514Z",
"owner": "69629023906488334"
},
"config": {
"name": "ip_allow_list",
"restWebhook": {
"interruptOnError": true
},
"restCall": {
"interruptOnError": true
},
"restAsync": {},
"timeout": "10s",
"endpoint": "https://example.com/hooks/ip_check"
},
"signingKey": "98KmsU67"
}
}
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"
}
]
}
Returned when the resource does not exist.
- 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"
}
]
}
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"
}
]
}