Project lifecycle · Mojo Up Docs

The caller's requests to join projects

GET/projects/v1/join-requests

The requests to join a project the caller has made, as a person.

Authorization

AuthorizationBearer <token>

A device access token from the device-code flow (aioe_at_…). A DPoP-bound token is sent as Authorization: DPoP <token> with a fresh DPoP proof on every request.

In: header

Mojo Up AI Cloud only, with a person's access token: the id of the organisation the request is for. A person's session is not tied to one organisation, so each request names it. Device tokens already carry their organisation.

Response Body

`application/json`

curl -X GET "https://example.com/projects/v1/join-requests"

[  {}]

Ask to join a project

POST/projects/v1/{id}/join-request

Asks the project's owners to let the caller in. Done as a person.

Authorization

AuthorizationBearer <token>

A device access token from the device-code flow (aioe_at_…). A DPoP-bound token is sent as Authorization: DPoP <token> with a fresh DPoP proof on every request.

In: header

Path Parameters

id*string

The project.

Header Parameters

X-Aioe-Organisation?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

note?string

Lengthlength <= 500

Response Body

`application/json`

curl -X POST "https://example.com/projects/v1/string/join-request" \  -H "Content-Type: application/json" \  -d '{}'

{}

Requests waiting on a project's owners

GET/projects/v1/{id}/requests

The pending requests to join the project, or to merge another project into it. Owners only; anyone else is answered 404.

Authorization

AuthorizationBearer <token>

A device access token from the device-code flow (aioe_at_…). A DPoP-bound token is sent as Authorization: DPoP <token> with a fresh DPoP proof on every request.

In: header

Path Parameters

id*string

The project.

Header Parameters

X-Aioe-Organisation?string

Response Body

`application/json`

curl -X GET "https://example.com/projects/v1/string/requests"

[  {}]

Approve a request

POST/projects/v1/{id}/join-requests/{requestId}/approve

Approves a request that belongs to this project. The body may carry a reason of at most 2000 characters.

Authorization

AuthorizationBearer <token>

A device access token from the device-code flow (aioe_at_…). A DPoP-bound token is sent as Authorization: DPoP <token> with a fresh DPoP proof on every request.

In: header

Path Parameters

id*string

The project.

requestId*string

The request.

Header Parameters

X-Aioe-Organisation?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

reason?string

Lengthlength <= 2000

Response Body

`application/json`

curl -X POST "https://example.com/projects/v1/string/join-requests/string/approve" \  -H "Content-Type: application/json" \  -d '{}'

{}

Decline a request

POST/projects/v1/{id}/join-requests/{requestId}/decline

Declines a request that belongs to this project. The body may carry a reason of at most 2000 characters.

Authorization

AuthorizationBearer <token>

A device access token from the device-code flow (aioe_at_…). A DPoP-bound token is sent as Authorization: DPoP <token> with a fresh DPoP proof on every request.

In: header

Path Parameters

id*string

The project.

requestId*string

The request.

Header Parameters

X-Aioe-Organisation?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

reason?string

Lengthlength <= 2000

Response Body

`application/json`

curl -X POST "https://example.com/projects/v1/string/join-requests/string/decline" \  -H "Content-Type: application/json" \  -d '{}'

{}

Merge a project into another

POST/projects/v1/{id}/merge

Owners of the source project, or an administrator. dryRun=1 answers what would move, with a sentence, and changes nothing. Otherwise the merge waits on the target's owners' approval and answers with the request; it happens at once when the caller owns both projects, or with force: true for an administrator.

Authorization

AuthorizationBearer <token>

A device access token from the device-code flow (aioe_at_…). A DPoP-bound token is sent as Authorization: DPoP <token> with a fresh DPoP proof on every request.

In: header

Path Parameters

id*string

The project to merge away.

Query Parameters

dryRun?string

1 or true to preview only.

Header Parameters

X-Aioe-Organisation?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

into*string

force?boolean

note?string

Response Body

`application/json`

curl -X POST "https://example.com/projects/v1/string/merge" \  -H "Content-Type: application/json" \  -d '{    "into": "string"  }'

{}

Archive a project

POST/projects/v1/{id}/archive

Owners, or an administrator. A project already archived or merged answers 409.

Authorization

AuthorizationBearer <token>

A device access token from the device-code flow (aioe_at_…). A DPoP-bound token is sent as Authorization: DPoP <token> with a fresh DPoP proof on every request.

In: header

Path Parameters

id*string

The project.

Header Parameters

X-Aioe-Organisation?string

Response Body

`application/json`

curl -X POST "https://example.com/projects/v1/string/archive"

{}

Restore an archived project

POST/projects/v1/{id}/restore

Owners, or an administrator.

Authorization

AuthorizationBearer <token>

A device access token from the device-code flow (aioe_at_…). A DPoP-bound token is sent as Authorization: DPoP <token> with a fresh DPoP proof on every request.

In: header

Path Parameters

id*string

The project.

Header Parameters

X-Aioe-Organisation?string

Response Body

`application/json`

curl -X POST "https://example.com/projects/v1/string/restore"

{}

Hand a project to a new owner

POST/projects/v1/{id}/transfer

One of the owners, or an administrator. The new owner is a person who has signed in to the organisation. An archived or merged project is restored first.

Authorization

AuthorizationBearer <token>

A device access token from the device-code flow (aioe_at_…). A DPoP-bound token is sent as Authorization: DPoP <token> with a fresh DPoP proof on every request.

In: header

Use the request body type in TypeScript.

to*string

Length1 <= length <= 200

Response Body

`application/json`

curl -X POST "https://example.com/projects/v1/string/transfer" \  -H "Content-Type: application/json" \  -d '{    "to": "string"  }'

{}

The caller's requests to join projectsCopy Anchor Link

AuthorizationCopy Anchor Link

Header ParametersCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

401application/json

403application/json

Ask to join a projectCopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Header ParametersCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

400application/json

401application/json

403application/json

404application/json

Requests waiting on a project's ownersCopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Header ParametersCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

401application/json

404application/json

Approve a requestCopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Header ParametersCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

401application/json

403application/json

404application/json

Decline a requestCopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Header ParametersCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

401application/json

403application/json

404application/json

Merge a project into anotherCopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Query ParametersCopy Anchor Link

Header ParametersCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

400application/json

401application/json

403application/json

404application/json

Archive a projectCopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Header ParametersCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

401application/json

403application/json

404application/json

409application/json

Restore an archived projectCopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Header ParametersCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

401application/json

403application/json

404application/json

409application/json

Hand a project to a new ownerCopy Anchor Link

AuthorizationCopy Anchor Link

The caller's requests to join projects

Authorization

Header Parameters

Response Body

`application/json`

`application/json`

`application/json`

Ask to join a project

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Requests waiting on a project's owners

Authorization

Path Parameters

Header Parameters

Response Body

`application/json`

`application/json`

`application/json`

Approve a request

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

Decline a request

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

Merge a project into another

Authorization

Path Parameters

Query Parameters

Header Parameters

Request Body

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Archive a project

Authorization

Path Parameters

Header Parameters

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Restore an archived project

Authorization

Path Parameters

Header Parameters

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Hand a project to a new owner

Authorization