pub.chive.claiming.getCoauthorRequests

chive.pub View official

Documentation

Get pending co-author requests for the authenticated user's eprints. Returns requests where the user is the eprint owner.

main query

Get pending co-author requests for the authenticated user's eprints. Returns requests where the user is the eprint owner.

Parameters

cursor string Optional

Pagination cursor for next page

limit integer Optional

Maximum number of results to return

Output

Encodingapplication/json
cursor string Optional

Cursor for next page of results

requests array Required

List of co-author requests

Errors

AuthenticationRequired Authentication is required to get co-author requests
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Pagination cursor for next page
Maximum number of results to return
View raw schema 
{
  "description": "Get pending co-author requests for the authenticated user's eprints. Returns requests where the user is the eprint owner.",
  "errors": [
    {
      "description": "Authentication is required to get co-author requests",
      "name": "AuthenticationRequired"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "description": "Cursor for next page of results",
          "type": "string"
        },
        "requests": {
          "description": "List of co-author requests",
          "items": {
            "ref": "#coauthorRequest",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "requests"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "cursor": {
        "description": "Pagination cursor for next page",
        "type": "string"
      },
      "limit": {
        "default": 50,
        "description": "Maximum number of results to return",
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      }
    },
    "type": "params"
  },
  "type": "query"
}
coauthorRequest object

A co-author claim request

Properties

authorIndex integer Required

Index of the author entry being claimed (0-based)

minimum: 0
authorName string Required

Name of the author entry being claimed

claimantDid string did Required

DID of the user requesting co-authorship

claimantName string Required

Display name of the claimant at time of request

createdAt string datetime Required

When the request was created

eprintOwnerDid string did Required

DID of the eprint owner (PDS owner)

eprintUri string at-uri Required

AT-URI of the eprint record

id integer Required

Unique request ID

message string Optional

Optional message from the claimant

maxLength: 1000 bytes
rejectionReason string Optional

Reason for rejection if rejected

maxLength: 500 bytes
reviewedAt string datetime Optional

When the request was reviewed

status string Required

Current status of the request

Known values: pending, approved, rejected
View raw schema 
{
  "description": "A co-author claim request",
  "properties": {
    "authorIndex": {
      "description": "Index of the author entry being claimed (0-based)",
      "minimum": 0,
      "type": "integer"
    },
    "authorName": {
      "description": "Name of the author entry being claimed",
      "type": "string"
    },
    "claimantDid": {
      "description": "DID of the user requesting co-authorship",
      "format": "did",
      "type": "string"
    },
    "claimantName": {
      "description": "Display name of the claimant at time of request",
      "type": "string"
    },
    "createdAt": {
      "description": "When the request was created",
      "format": "datetime",
      "type": "string"
    },
    "eprintOwnerDid": {
      "description": "DID of the eprint owner (PDS owner)",
      "format": "did",
      "type": "string"
    },
    "eprintUri": {
      "description": "AT-URI of the eprint record",
      "format": "at-uri",
      "type": "string"
    },
    "id": {
      "description": "Unique request ID",
      "type": "integer"
    },
    "message": {
      "description": "Optional message from the claimant",
      "maxLength": 1000,
      "type": "string"
    },
    "rejectionReason": {
      "description": "Reason for rejection if rejected",
      "maxLength": 500,
      "type": "string"
    },
    "reviewedAt": {
      "description": "When the request was reviewed",
      "format": "datetime",
      "type": "string"
    },
    "status": {
      "description": "Current status of the request",
      "knownValues": [
        "pending",
        "approved",
        "rejected"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "eprintUri",
    "eprintOwnerDid",
    "claimantDid",
    "claimantName",
    "authorIndex",
    "authorName",
    "status",
    "createdAt"
  ],
  "type": "object"
}

Lexicon Garden

@