Projekte
Diese Referenz wird aus der OpenAPI-Spezifikation erzeugt; die Beschreibungen der Endpunkte und Felder sind auf Englisch.
Limits with current use, and the restrictions staff may have set: creating resources disabled altogether
(creation_blocked, with a reason) or in some locations (blocked_locations). Readable by every member of
the project, so panels can disable create buttons before a request fails.
AutorisierungBearer <token>Quota
application/json- response
quota*curl -X GET "https://example.com/quota"{ "quota": { "account_status": "active", "creation_blocked": true, "creation_block_reason": "string", "blocked_locations": [ "string" ], "limits": { "property1": { "limit": 0, "used": 0 }, "property2": { "limit": 0, "used": 0 } } }}cookieAuthodx_session<token>Projects
application/json- response
projects*array<>curl -X GET "https://example.com/projects"{ "projects": [ { "id": 0, "name": "string", "organization_id": 0, "role": "admin", "created": "2019-08-24T14:15:22Z" } ]}cookieAuthodx_session<token>application/json- body
name*string1 <= length <= 64organization_id?integerDefaults to the personal organization
int64Created
application/json- response
project*curl -X POST "https://example.com/projects" \ -H "Content-Type: application/json" \ -d '{ "name": "string" }'{ "project": { "id": 0, "name": "string", "organization_id": 0, "role": "admin", "created": "2019-08-24T14:15:22Z" }}cookieAuthodx_session<token>id*integerint64Project
application/json- response
project*curl -X GET "https://example.com/projects/0"{ "project": { "id": 0, "name": "string", "organization_id": 0, "role": "admin", "created": "2019-08-24T14:15:22Z" }}cookieAuthodx_session<token>id*integerint64application/json- body
name*string1 <= length <= 64Updated
application/json- response
project*curl -X PATCH "https://example.com/projects/0" \ -H "Content-Type: application/json" \ -d '{ "name": "string" }'{ "project": { "id": 0, "name": "string", "organization_id": 0, "role": "admin", "created": "2019-08-24T14:15:22Z" }}Fails with project_not_empty while the project still has resources.
cookieAuthodx_session<token>id*integerint64Deleted
curl -X DELETE "https://example.com/projects/0"cookieAuthodx_session<token>id*integerint64Tokens (secrets are never returned again)
application/json- response
tokens*array<>curl -X GET "https://example.com/projects/0/tokens"{ "tokens": [ { "allowed_ips": [ "203.0.113.0/24" ], "id": 0, "name": "string", "prefix": "string", "scope": "read", "created": "2019-08-24T14:15:22Z", "expires": "2019-08-24T14:15:22Z", "last_used": "2019-08-24T14:15:22Z" } ]}cookieAuthodx_session<token>id*integerint64application/json- body
name*string1 <= length <= 64scope*string"read""read_write"expires_in_days?integer1 <= value <= 3650allowed_ips?array<>IP addresses or CIDR ranges (IPv4 or IPv6) the token may be used from. Empty: any address.
items <= 50Created. secret is shown only in this response.
application/json- response
token*secret*stringcurl -X POST "https://example.com/projects/0/tokens" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "scope": "read" }'{ "token": { "allowed_ips": [ "203.0.113.0/24" ], "id": 0, "name": "string", "prefix": "string", "scope": "read", "created": "2019-08-24T14:15:22Z", "expires": "2019-08-24T14:15:22Z", "last_used": "2019-08-24T14:15:22Z" }, "secret": "odx_k3j2h1_2fK9..."}Sets the addresses the token may be used from. An empty list allows any address.
cookieAuthodx_session<token>id*integerint64token_id*integerint64application/json- body
allowed_ips*array<>IP addresses or CIDR ranges (IPv4 or IPv6) the token may be used from. Empty: any address.
items <= 50Updated
application/json- response
token*curl -X PATCH "https://example.com/projects/0/tokens/0" \ -H "Content-Type: application/json" \ -d '{ "allowed_ips": [ "203.0.113.0/24" ] }'{ "token": { "allowed_ips": [ "203.0.113.0/24" ], "id": 0, "name": "string", "prefix": "string", "scope": "read", "created": "2019-08-24T14:15:22Z", "expires": "2019-08-24T14:15:22Z", "last_used": "2019-08-24T14:15:22Z" }}cookieAuthodx_session<token>id*integerint64token_id*integerint64Revoked
curl -X DELETE "https://example.com/projects/0/tokens/0"