AI Studios - Publication Co-Creators

POST

https://host.com/api/v1/aistudios/co-creators/

POST

/api/v1/aistudios/co-creators/

$ curl -X POST /api/v1/aistudios/co-creators/ \
>      -H "Content-Type: application/json" \
>      -d '{
>   "publication_url": "https://aistudios.com/publications/ai-innovations-2024"
> }'

1 {
2   "count": 3,
3   "results": [
4     {
5       "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
6       "user": {
7         "id": 101,
8         "username": "alice_wong",
9         "full_name": "Alice Wong",
10         "profile_picture": "https://cdn.aistudios.com/profiles/alice_wong.jpg",
11         "is_verified": true
12       },
13       "created_at": "2024-01-15T09:30:00Z",
14       "role": "owner",
15       "status": "completed"
16     },
17     {
18       "uid": "b2c3d4e5-f678-90ab-cdef-234567890abc",
19       "user": {
20         "id": 102,
21         "username": "bob_jones",
22         "full_name": "Bob Jones",
23         "profile_picture": "https://cdn.aistudios.com/profiles/bob_jones.jpg",
24         "is_verified": true
25       },
26       "created_at": "2024-02-10T14:45:00Z",
27       "role": "editor",
28       "status": "in_progress"
29     },
30     {
31       "uid": "c3d4e5f6-7890-abcd-ef12-34567890abcd",
32       "user": {
33         "id": 103,
34         "username": "carla_martin",
35         "full_name": "Carla Martin",
36         "profile_picture": "https://cdn.aistudios.com/profiles/carla_martin.jpg",
37         "is_verified": false
38       },
39       "created_at": "2024-03-05T08:20:00Z",
40       "role": "viewer",
41       "status": "completed"
42     }
43   ],
44   "next": "https://api.aistudios.com/v1/aistudios/co-creators/?page=2"
45 }

POST: Get co-creators for a specific publication/studio with minimal user details. Returns users who have co-creator access to the publication including their role and status. Only includes co-creators with actual IAMUser accounts (not email-only invitations). Requires a publication URL in the POST body to filter co-creators by publication.

Query parameters

searchstringOptional

Search co-creators by username or full name

Request

This endpoint expects an object.

userobjectRequired

Minimal creator/user serializer for aistudios explore pages. Includes profile picture from user details.

roleenum or any or nullOptional

Role of the co-creator in the publication

owner - Owner
admin - Admin
editor - Editor
viewer - Viewer

statusenumOptional

not_started - Not Started
in_progress - In Progress
completed - Completed
failed - Failed

Allowed values:

Response

Successfully retrieved publication co-creators

countinteger

resultslist of objects

nextstring or nullformat: "uri"

previousstring or nullformat: "uri"

Errors

400

Bad Request Error

404

Not Found Error