Rev orgs
Create Rev Org
Creates a Rev organization in the authenticated user's Dev 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
accountstring
Account Id to associate with this Rev organization.
Format
iddescription?string
Description of the Rev organization.
Format
textdisplay_namestring
Name of the Rev organization.
Format
textdomain?stringDeprecated
Company's domain name. Example - 'devrev.ai'.
Format
textenvironment?org-environment
The environment of the Org. Defaults to 'production' if not specified.
Value in
"production" | "staging" | "test"external_ref?string
External ref is a custom unique identifier which is a reference to an unique id for this organization's data in some system of records.
Format
texttier?string
The tier of the RevOrg.
Format
textResponse Body
curl -X POST "https://api.devrev.ai/rev-orgs.create" \ -H "Content-Type: application/json" \ -d '{ "account": "ACC-12345", "display_name": "string" }'{
"rev_org": {
"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",
"description": "string",
"domain": "string",
"external_ref": "string",
"primary_rev_org": {
"type": "rev_org",
"display_id": "string",
"id": "string",
"display_name": "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": "conflict"
}{
"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"
}