Organisations (/v2/organisations)

Source: src/Resource/V2/OrganisationsResource.php

Access

$client->organisations

CRUD

Method	HTTP	Path
list(): list<Organisation>	GET	/v2/organisations
get(string $id): Organisation	GET	/v2/organisations/{id}
create(array $data): Organisation	POST	/v2/organisations
update(string $id, array $data): Organisation	PUT	/v2/organisations/{id}
delete(string $id): void	DELETE	/v2/organisations/{id}

Members

public function members(string $organisationId): list<Member>
public function addMember(string $organisationId, string $userEmail, MemberRole $role, ?string $job = null): void
public function updateMember(string $organisationId, string $userId, MemberRole $role, ?string $job = null): void
public function removeMember(string $organisationId, string $userId): void

MemberRole is the enum at CleverCloud\Sdk\Model\Enum\MemberRole (Admin, Manager, Developer, Accounting).

Method	HTTP	Path	Body
members()	GET	/v2/organisations/{id}/members	—
addMember()	POST	/v2/organisations/{id}/members	{"email": "...", "role": "ADMIN", "job": "..."?}
updateMember()	PUT	/v2/organisations/{id}/members/{userId}	{"role": "...", "job": "..."?}
removeMember()	DELETE	/v2/organisations/{id}/members/{userId}	—

OAuth consumers (per-organisation)

Same CRUD as user-level consumers but scoped to the organisation:

public function consumers(string $organisationId): list<OAuthConsumer>
public function getConsumer(string $organisationId, string $consumerKey): OAuthConsumer
public function createConsumer(string $organisationId, array $data): OAuthConsumer
public function updateConsumer(string $organisationId, string $consumerKey, array $data): OAuthConsumer
public function deleteConsumer(string $organisationId, string $consumerKey): void

Routes: /v2/organisations/{id}/consumers[/{consumerKey}]. Payload shape same as Self consumers.

Namespaces (TCP / network routing)

public function namespaces(string $organisationId): list<Namespace_>

GET /v2/organisations/{id}/namespaces. Returns the namespaces the organisation is authorised to bind TCP ports on (see TCP redirections).

Invitations

public function invitations(string $organisationId): list<Invitation>
public function cancelInvitation(string $organisationId, string $invitationId): void

Method	HTTP	Path
invitations()	GET	/v2/organisations/{id}/members/invitations
cancelInvitation()	DELETE	/v2/organisations/{id}/members/invitations/{invitationId}

Invitation exposes id, organisationId, inviteeEmail, inviterUserId, role (MemberRole), status, and the createdAt, expiresAt and acceptedAt dates as RFC 3339 strings.

Avatar, billing details, drain policy

public function setAvatar(string $organisationId, AvatarSource $source): string
public function paymentInfo(string $organisationId): PaymentInfo
public function drainPolicy(string $organisationId): array<string, mixed>

Method	HTTP	Path	Notes
setAvatar()	PUT	/v2/organisations/{id}/avatar	Body {"source": "gravatar"\|"github"}, returns the avatar URL
paymentInfo()	GET	/v2/organisations/{id}/payment-info	Same PaymentInfo model as Self
drainPolicy()	GET	/v2/organisations/{id}/drain-policy	Raw {enforcement, drainTemplates}

In the drain policy, enforcement maps each drain kind (LOG, ACCESSLOG, AUDITLOG) to NONE or REQUIRED.

Organisation-wide deployments and instances

public function deployments(string $organisationId, ?int $limit = null): array<string, list<Deployment>>
public function instances(string $organisationId): array<string, list<array<string, mixed>>>

Method	HTTP	Path
deployments()	GET	/v2/organisations/{id}/deployments (?limit= when set)
instances()	GET	/v2/organisations/{id}/instances

Both return a map keyed by application id (app_...). The map is empty when the caller's role cannot see the organisation's applications.

OAuth consumer secret

public function consumerSecret(string $organisationId, string $consumerKey): string

GET /v2/organisations/{id}/consumers/{key}/secret.