List Rev Orgs (POST) | DevRev

Gets the list of Rev organizations' information belonging to the authenticated user's Dev Organization which the user is also authorized to access.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

accountlist of stringsOptional

Filters by account.

created_bylist of stringsOptional

Filters by creator.

created_dateobjectOptional

cursorstringOptionalformat: "text"

The cursor to resume iteration from. If not provided, then iteration starts from the beginning.

custom_field_filterlist of stringsOptional

Filters on custom fields. Input will be of the format (custom_field_filter=field_name1:val1,val2,val3&custom_field_filter=field_name2:val1,val2).

custom_fieldsobjectOptional

Filters for custom fields.

display_namelist of stringsOptional

Array of display names of Rev orgs to be filtered.

external_reflist of stringsOptional

List of external refs to filter Rev organizations for.

limitintegerOptional

The maximum number of Rev organizations to be retrieved per page.

modeenumOptional

The iteration mode to use. If “after”, then entries after the provided cursor will be returned, or if no cursor is provided, then from the beginning. If “before”, then entries before the provided cursor will be returned, or if no cursor is provided, then from the end. Entries will always be returned in the specified sort-by order.

Allowed values:

modified_dateobjectOptional

sort_bylist of stringsOptional

Fields to sort the Rev organizations by and the direction to sort them.

tagslist of stringsOptional

List of tags to be filtered.

Response

The response to getting a list of Rev organizations' information.

rev_orgslist of objects

List with all of the Rev organizations' information.

next_cursorstring or nullformat: "text"

The cursor used to iterate subsequent results in accordance to the sort order. If not set, then no later elements exist.

prev_cursorstring or nullformat: "text"

The cursor used to iterate preceding results in accordance to the sort order. If not set, then no prior elements exist.

1	curl -X POST https://api.devrev.ai/rev-orgs.list \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{}'

1	{
2	"rev_orgs": [
3	{
4	"id": "foo",
5	"account": {
6	"id": "foo",
7	"display_id": "foo",
8	"display_name": "foo"
9	},
10	"artifacts": [
11	{
12	"id": "foo",
13	"display_id": "foo",
14	"file": {
15	"type": "foo",
16	"name": "foo",
17	"size": 42
18	}
19	}
20	],
21	"created_by": {
22	"display_id": "foo",
23	"id": "foo",
24	"display_name": "foo",
25	"display_picture": {
26	"display_id": "foo",
27	"id": "foo",
28	"file": {
29	"type": "foo",
30	"name": "foo",
31	"size": 42
32	}
33	},
34	"email": "foo",
35	"full_name": "foo",
36	"state": "active"
37	},
38	"created_date": "2023-01-01T12:00:00.000Z",
39	"custom_fields": {},
40	"custom_schema_fragments": [
41	"foo"
42	],
43	"description": "foo",
44	"display_id": "foo",
45	"display_name": "foo",
46	"external_ref": "foo",
47	"modified_by": {
48	"display_id": "foo",
49	"id": "foo",
50	"display_name": "foo",
51	"display_picture": {
52	"display_id": "foo",
53	"id": "foo",
54	"file": {
55	"type": "foo",
56	"name": "foo",
57	"size": 42
58	}
59	},
60	"email": "foo",
61	"full_name": "foo",
62	"state": "active"
63	},
64	"modified_date": "2023-01-01T12:00:00.000Z",
65	"primary_rev_org": {
66	"display_id": "foo",
67	"id": "foo",
68	"display_name": "foo"
69	},
70	"stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id",
71	"subtype": "foo",
72	"tags": [
73	{
74	"tag": {
75	"id": "foo",
76	"name": "foo",
77	"display_id": "foo",
78	"style_new": {
79	"color": "foo"
80	}
81	},
82	"value": "foo"
83	}
84	],
85	"domain": "foo"
86	}
87	],
88	"next_cursor": "foo",
89	"prev_cursor": "foo"
90	}

Headers

Request

Response

Errors