targetdomain accounts
Download SpecGet all accounts in target domain
sortkey
string
sortdir
string
- Enum
-
- asc
- desc
limit
int
offset
int
targetDomainID
string
uuid
required
oauth
Required Scopes:
admin
Get all accounts in target domain
All Scopes
-
admin
· Admin scope - used for built-in PrivX admin account -
hostsManage
· Clients with hosts-manage scope -
hostsProvisioning
· Deploy script users -
hostsView
· Clients with hosts-view scope -
service
· Microservice scope - used for communication between PrivX microservices -
user
· Normal users
- Flow Type:
- authorization_code
- Auth URL:
- https://api.x.com/v1/auth/auth
- Token URL:
- https://api.x.com/v1/auth/auth
Response
Success
{
"count": 123,
"items": [
{
"id": "5bf77342-221c-11ee-be56-0242ac120002",
"username": "string",
"email": "string",
"full_name": "string",
"source_id": "string",
"security_id": "string",
"additional_data": {},
"target_domain": {
"id": "5bf77342-221c-11ee-be56-0242ac120002",
"name": "string",
"deleted": true
},
"state": "MANAGED",
"ignored": true,
"comment": "string",
"created": "2023-06-07T17:32:28Z",
"author": "5bf77342-221c-11ee-be56-0242ac120002",
"updated": "2023-06-07T17:32:28Z",
"updated_by": "5bf77342-221c-11ee-be56-0242ac120002"
}
]
}
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Error
{
"error_code": "GENERAL_ERROR",
"error_message": "string",
"property": "string",
"details": [
null
]
}
count
int
items
array[object]
object
id
string
uuid
username
string
string
full_name
string
source_id
string
security_id
string
additional_data
object (additional_data)
target_domain
object (target_domain)
id
string
uuid
name
string
deleted
boolean
state
string
- Enum
-
- MANAGED
- UNMANAGED
- NEW
- REMOVED
ignored
boolean
comment
string
created
string
date-time
author
string
uuid
updated
string
date-time
updated_by
string
uuid
error_code
string
required
Standard error code denoting the error type
- Enum
-
- GENERAL_ERROR
- BAD_REQUEST
- PERMISSION_DENIED
- INVALID_REQUEST_DATA
- REQUIRED_VALUE_MISSING
- VALUE_OUT_OF_BOUNDS
- VALUE_INCORRECT_TYPE
- VALUE_INCORRECT_FORMAT
- VALUE_DUPLICATE
- CONFIGURATION_ERROR
- OUT_OF_RESOURCES
- MAX_LOAD
- TOO_MANY_CONNECTIONS
- DATABASE_ERROR
- CACHE_ERROR
- INTRA_SERVICE_COMMUNICATION_ERROR
error_message
string
Textual, human readable error message
property
string
The property name causing the error
details
array[]
An array of errors describing the error in more detail
reference (error)
recursiveSearch accounts in target domain
keywords
string
Space or comma separated list of search keywords
created_after
string
date-time
created_before
string
date-time
updated_after
string
date-time
updated_before
string
date-time
state
string
- Enum
-
- MANAGED
- UNMANAGED
- NEW
- REMOVED
ignored
boolean
targetDomainID
string
uuid
required
sortkey
string
sortdir
string
- Enum
-
- asc
- desc
limit
int
offset
int
oauth
Required Scopes:
admin
Search accounts in target domain
All Scopes
-
admin
· Admin scope - used for built-in PrivX admin account -
hostsManage
· Clients with hosts-manage scope -
hostsProvisioning
· Deploy script users -
hostsView
· Clients with hosts-view scope -
service
· Microservice scope - used for communication between PrivX microservices -
user
· Normal users
- Flow Type:
- authorization_code
- Auth URL:
- https://api.x.com/v1/auth/auth
- Token URL:
- https://api.x.com/v1/auth/auth
Request
{
"keywords": "string",
"created_after": "2023-06-07T17:32:28Z",
"created_before": "2023-06-07T17:32:28Z",
"updated_after": "2023-06-07T17:32:28Z",
"updated_before": "2023-06-07T17:32:28Z",
"state": "MANAGED",
"ignored": true
}
Response
Success
{
"count": 123,
"items": [
{
"id": "5bf77342-221c-11ee-be56-0242ac120002",
"username": "string",
"email": "string",
"full_name": "string",
"source_id": "string",
"security_id": "string",
"additional_data": {},
"target_domain": {
"id": "5bf77342-221c-11ee-be56-0242ac120002",
"name": "string",
"deleted": true
},
"state": "MANAGED",
"ignored": true,
"comment": "string",
"created": "2023-06-07T17:32:28Z",
"author": "5bf77342-221c-11ee-be56-0242ac120002",
"updated": "2023-06-07T17:32:28Z",
"updated_by": "5bf77342-221c-11ee-be56-0242ac120002"
}
]
}
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Error
{
"error_code": "GENERAL_ERROR",
"error_message": "string",
"property": "string",
"details": [
null
]
}
count
int
items
array[object]
object
id
string
uuid
username
string
string
full_name
string
source_id
string
security_id
string
additional_data
object (additional_data)
target_domain
object (target_domain)
id
string
uuid
name
string
deleted
boolean
state
string
- Enum
-
- MANAGED
- UNMANAGED
- NEW
- REMOVED
ignored
boolean
comment
string
created
string
date-time
author
string
uuid
updated
string
date-time
updated_by
string
uuid
error_code
string
required
Standard error code denoting the error type
- Enum
-
- GENERAL_ERROR
- BAD_REQUEST
- PERMISSION_DENIED
- INVALID_REQUEST_DATA
- REQUIRED_VALUE_MISSING
- VALUE_OUT_OF_BOUNDS
- VALUE_INCORRECT_TYPE
- VALUE_INCORRECT_FORMAT
- VALUE_DUPLICATE
- CONFIGURATION_ERROR
- OUT_OF_RESOURCES
- MAX_LOAD
- TOO_MANY_CONNECTIONS
- DATABASE_ERROR
- CACHE_ERROR
- INTRA_SERVICE_COMMUNICATION_ERROR
error_message
string
Textual, human readable error message
property
string
The property name causing the error
details
array[]
An array of errors describing the error in more detail
reference (error)
recursiveGet target domain account
targetDomainID
string
uuid
required
accountID
string
uuid
required
oauth
Required Scopes:
admin
Get target domain account
All Scopes
-
admin
· Admin scope - used for built-in PrivX admin account -
hostsManage
· Clients with hosts-manage scope -
hostsProvisioning
· Deploy script users -
hostsView
· Clients with hosts-view scope -
service
· Microservice scope - used for communication between PrivX microservices -
user
· Normal users
- Flow Type:
- authorization_code
- Auth URL:
- https://api.x.com/v1/auth/auth
- Token URL:
- https://api.x.com/v1/auth/auth
Response
Success
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
No schema
Error
{
"error_code": "GENERAL_ERROR",
"error_message": "string",
"property": "string",
"details": [
null
]
}
error_code
string
required
Standard error code denoting the error type
- Enum
-
- GENERAL_ERROR
- BAD_REQUEST
- PERMISSION_DENIED
- INVALID_REQUEST_DATA
- REQUIRED_VALUE_MISSING
- VALUE_OUT_OF_BOUNDS
- VALUE_INCORRECT_TYPE
- VALUE_INCORRECT_FORMAT
- VALUE_DUPLICATE
- CONFIGURATION_ERROR
- OUT_OF_RESOURCES
- MAX_LOAD
- TOO_MANY_CONNECTIONS
- DATABASE_ERROR
- CACHE_ERROR
- INTRA_SERVICE_COMMUNICATION_ERROR
error_message
string
Textual, human readable error message
property
string
The property name causing the error
details
array[]
An array of errors describing the error in more detail
reference (error)
recursiveModify target domain account
ignored
boolean
comment
string
targetDomainID
string
uuid
required
accountID
string
uuid
required
oauth
Required Scopes:
admin
Modify target domain account
All Scopes
-
admin
· Admin scope - used for built-in PrivX admin account -
hostsManage
· Clients with hosts-manage scope -
hostsProvisioning
· Deploy script users -
hostsView
· Clients with hosts-view scope -
service
· Microservice scope - used for communication between PrivX microservices -
user
· Normal users
- Flow Type:
- authorization_code
- Auth URL:
- https://api.x.com/v1/auth/auth
- Token URL:
- https://api.x.com/v1/auth/auth
Request
{
"ignored": true,
"comment": "string"
}
Response
Account was successfully modified
{
"version": 123,
"created": "2023-06-07T17:32:28Z"
}
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
version
int
created
string
date-time
Error
{
"error_code": "GENERAL_ERROR",
"error_message": "string",
"property": "string",
"details": [
null
]
}
error_code
string
required
Standard error code denoting the error type
- Enum
-
- GENERAL_ERROR
- BAD_REQUEST
- PERMISSION_DENIED
- INVALID_REQUEST_DATA
- REQUIRED_VALUE_MISSING
- VALUE_OUT_OF_BOUNDS
- VALUE_INCORRECT_TYPE
- VALUE_INCORRECT_FORMAT
- VALUE_DUPLICATE
- CONFIGURATION_ERROR
- OUT_OF_RESOURCES
- MAX_LOAD
- TOO_MANY_CONNECTIONS
- DATABASE_ERROR
- CACHE_ERROR
- INTRA_SERVICE_COMMUNICATION_ERROR
error_message
string
Textual, human readable error message
property
string
The property name causing the error
details
array[]
An array of errors describing the error in more detail
reference (error)
recursiveModify target domain account
ids
array[string]
string
uuid
changes
object (changes)
ignored
boolean
comment
string
targetDomainID
string
uuid
required
oauth
Required Scopes:
admin
Modify target domain account
All Scopes
-
admin
· Admin scope - used for built-in PrivX admin account -
hostsManage
· Clients with hosts-manage scope -
hostsProvisioning
· Deploy script users -
hostsView
· Clients with hosts-view scope -
service
· Microservice scope - used for communication between PrivX microservices -
user
· Normal users
- Flow Type:
- authorization_code
- Auth URL:
- https://api.x.com/v1/auth/auth
- Token URL:
- https://api.x.com/v1/auth/auth
Request
{
"ids": [
"5bf77342-221c-11ee-be56-0242ac120002"
],
"changes": {
"ignored": true,
"comment": "string"
}
}
Response
Account batch was successfully modified
{
"version": 123,
"created": "2023-06-07T17:32:28Z"
}
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
Empty response
version
int
created
string
date-time
Error
{
"error_code": "GENERAL_ERROR",
"error_message": "string",
"property": "string",
"details": [
null
]
}
error_code
string
required
Standard error code denoting the error type
- Enum
-
- GENERAL_ERROR
- BAD_REQUEST
- PERMISSION_DENIED
- INVALID_REQUEST_DATA
- REQUIRED_VALUE_MISSING
- VALUE_OUT_OF_BOUNDS
- VALUE_INCORRECT_TYPE
- VALUE_INCORRECT_FORMAT
- VALUE_DUPLICATE
- CONFIGURATION_ERROR
- OUT_OF_RESOURCES
- MAX_LOAD
- TOO_MANY_CONNECTIONS
- DATABASE_ERROR
- CACHE_ERROR
- INTRA_SERVICE_COMMUNICATION_ERROR
error_message
string
Textual, human readable error message
property
string
The property name causing the error
details
array[]
An array of errors describing the error in more detail
reference (error)
recursiveWas this page helpful?