CAcapy
threads

Create thread

Changed on
post/api/v1/threads

Request

  • Base URL
    https://api.capy.ai
  • Auth
    HTTP bearer

Request body

requestIdstring required
projectIdstring required
titlestring
messagestring required
machineSize'small' | 'medium' | 'large' | 'ultra' | 'hyper' | 'bigguy'
authorIdstring
visibility'org' | 'private'

Who can see the thread: org for everyone at the organization, private for its owner and the people it is shared with. Absent, the owner's own default applies, else the organization's. private needs a human owner who may create private work, so a service key must name authorId.

personalboolean
pullRequestAuthor'user' | 'capy'

Who authors this thread's pull requests on GitHub: capy for the Capy GitHub App, user for the thread's acting human (the authorId member, or the key's creator for a service key). Commits and pushes keep the Git identity preference. Absent leaves the preference in charge; a replayed requestId keeps the original value.

Response

Thread

idstring required
projectIdstring nullable required
authorIdstring nullable required
previousAuthorIdstring nullable required
titlestring nullable required
titleCustomboolean required
status'working' | 'waiting' | 'idle' | 'failed' | 'archived' required
archivedboolean required
lastModelIdstring nullable required
pullRequestAuthor'user' | 'capy' nullable required

Who authors this thread's pull requests on GitHub: capy for the Capy GitHub App, user for the thread's acting human. Null means the acting human's Git identity preference decides.

createdAtstring required
updatedAtstring required
lastActivityAtstring nullable required
hasUnreadsboolean required
mentionCountinteger required
owedboolean required
needsYouboolean
crewNeedsYouinteger
participatedboolean
crewMentionCountinteger
crewCountinteger
memberboolean required
subscribedboolean
personalboolean
visibility'org' | 'private'

Changes