AI Studios - Publication Co-Creators | AISquare Studio

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

{
  "count": 3,
  "results": [
    {
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "user": {
        "id": 101,
        "username": "alice_wong",
        "full_name": "Alice Wong",
        "profile_picture": "https://cdn.aistudios.com/profiles/alice_wong.jpg",
        "is_verified": true
      },
      "created_at": "2024-01-15T09:30:00Z",
      "role": "owner",
      "status": "completed"
    },
    {
      "uid": "b2c3d4e5-f678-90ab-cdef-234567890abc",
      "user": {
        "id": 102,
        "username": "bob_jones",
        "full_name": "Bob Jones",
        "profile_picture": "https://cdn.aistudios.com/profiles/bob_jones.jpg",
        "is_verified": true
      },
      "created_at": "2024-02-10T14:45:00Z",
      "role": "editor",
      "status": "in_progress"
    },
    {
      "uid": "c3d4e5f6-7890-abcd-ef12-34567890abcd",
      "user": {
        "id": 103,
        "username": "carla_martin",
        "full_name": "Carla Martin",
        "profile_picture": "https://cdn.aistudios.com/profiles/carla_martin.jpg",
        "is_verified": false
      },
      "created_at": "2024-03-05T08:20:00Z",
      "role": "viewer",
      "status": "completed"
    }
  ],
  "next": "https://api.aistudios.com/v1/aistudios/co-creators/?page=2"
}

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

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

* `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