Dev users
List Dev Users
Lists users within your organization.
AuthorizationBearer <token>
All the DevRev APIs require a token to authenticate the user. Provide Authorization: Bearer <TOKEN> as a header to every API request.
How do I find my token?
In: header
Query Parameters
cursor?string
The cursor to resume iteration from. If not provided, then iteration starts from the beginning.
Format
textemail?array<string>
Filters Dev users based on email addresses.
external_identity.id?string
Unique ID of the user in the external source.
Format
textexternal_identity.issuer?string
Issuer of the external identity of the user.
Format
textlimit?integer
The maximum number of Dev users to return. The default is '50'.
Format
int32mode?string
The iteration mode to use, otherwise if not set, then "after" is used.
Value in
"after" | "before"sort_by?array<string>
Fields to sort the Dev users by and the direction to sort them.
state?array<user-state>
Filters Dev users based on state.
Response Body
curl -X GET "https://api.devrev.ai/dev-users.list?cursor=string&email=string&external_identity.id=string&external_identity.issuer=string&limit=0&mode=after&sort_by=string&state=active"{
"dev_users": [
{
"created_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"created_date": "2023-01-01T12:00:00.000Z",
"display_id": "string",
"id": "string",
"modified_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"modified_date": "2023-01-01T12:00:00.000Z",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"phone_numbers": [
"string"
],
"primary_identity": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"state": "active",
"experience_start_date": "2023-01-01T12:00:00.000Z",
"external_identities": [
{
"display_name": "string",
"id": "string",
"is_verified": true,
"issuer": "string"
}
],
"job_history": [
{
"employment_status": {
"id": 0,
"label": "string",
"ordinal": 0,
"value": null
},
"end_date": "2023-01-01T12:00:00.000Z",
"is_current": true,
"location": "string",
"start_date": "2023-01-01T12:00:00.000Z",
"title": "string"
}
],
"reports_to": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"skills": [
{
"name": "string"
}
]
}
],
"next_cursor": "string",
"prev_cursor": "string"
}{
"detail": "string",
"message": "string",
"type": "artifact_already_attached_to_a_parent",
"existing_parent": "string",
"is_same": true
}{
"detail": "string",
"message": "string",
"type": "unauthenticated"
}{
"detail": "string",
"message": "string",
"type": "forbidden"
}{
"detail": "string",
"message": "string",
"type": "too_many_requests",
"retry_after": 0
}{
"detail": "string",
"message": "string",
"type": "internal_error",
"reference_id": "string"
}{
"detail": "string",
"message": "string",
"type": "service_unavailable"
}