Rev orgs

Create Rev Org

Creates a Rev organization in the authenticated user's Dev organization.

POST
/rev-orgs.create

Authorization

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

Request Body

accountstring

Account Id to associate with this Rev organization.

Formatid
artifacts?array<string>

The IDs of the artifacts to associate with the Rev organization.

custom_fields?object

Application-defined custom fields.

Empty Object

custom_schema_fragments?array<string>

Schema fragment IDs associated with this Rev organization.

description?string

Description of the Rev organization.

Formattext
display_namestring

Name of the Rev organization.

Formattext
domain?stringDeprecated

Company's domain name. Example - 'devrev.ai'.

Formattext
environment?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.

Formattext
tags?array<set-tag-with-value>

Tags associated with the Rev organization.

tier?string

The tier of the RevOrg.

Formattext

Response 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",
    "account": {
      "display_id": "string",
      "id": "string",
      "display_name": "string"
    },
    "artifacts": [
      {
        "display_id": "string",
        "id": "string",
        "file": {
          "type": "string",
          "name": "string",
          "size": 0
        }
      }
    ],
    "custom_fields": {},
    "custom_schema_fragments": [
      "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id"
    ],
    "description": "string",
    "domain": "string",
    "external_ref": "string",
    "primary_rev_org": {
      "type": "account",
      "display_id": "string",
      "id": "string",
      "display_name": "string"
    },
    "stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id",
    "subtype": "string",
    "tags": [
      {
        "tag": {
          "display_id": "string",
          "id": "string",
          "name": "string",
          "style_new": {
            "color": "string"
          }
        },
        "value": "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"
}