Skip to content

Platform / Reference

Platform CLI commands

Updated · 6 min read

Every origin id, origin admin and origin config command with its flags: log in, manage organizations and projects, and set CLI profile values.

On this page16 sections

This page lists every origin id, origin admin and origin config command, and the options every origin command accepts. For installing and configuring the CLI, see Use the CLI.

Global options

Every origin command accepts these options before the command group.

OptionDescription
--config <FILE>Accepted, but doesn’t change which profile the CLI reads.
--api <URL>GraphQL API endpoint to send requests to. Defaults to https://api.origincloud.eu/graphql.
--debugAccepted, but doesn’t change the output.

The CLI’s own help text still describes --config as choosing a configuration file and --debug as printing debugging information. Neither has that effect in v1.9.15. See Global options.

login

Log in through your browser, or with a code on another device. Opens the Origin Cloud login page in your browser and waits for you to log in there. With --device, prints an address and a code to approve on any other device instead, for machines without a browser such as an SSH session. The CLI never asks for your password.

terminal
origin id login [OPTIONS]
OptionRequiredDescription
--devicenoLog in by approving a code on another device, instead of opening a browser on this machine.

token

Print the access token of the current login session, for calling the GraphQL API directly.

terminal
origin id token [OPTIONS]
OptionRequiredDescription
--as-headernoPrint the token as an HTTP Authorization header (Authorization: Bearer <token>).
--rawnoPrint plain text with no JSON envelope, for direct use in shell one-liners (e.g. curl -H "$(origin id token --as-header --raw)")

create-organisation

Create organisation from its name alone; its billing details are added afterwards on its default billing account. register-organisation does both in one step.

terminal
origin admin create-organisation --name <NAME>
OptionRequiredDescription
--name <NAME>yesName of the organization.

register-organisation

Register organisation. The billing details become its default billing account, so the organisation is billable from the start.

terminal
origin admin register-organisation [OPTIONS] --name <NAME> --street <STREET> --city <CITY> --postal-code <POSTAL_CODE> --country <COUNTRY> --invoice-email <INVOICE_EMAIL> --contact-person <CONTACT_PERSON>
OptionRequiredDescription
--name <NAME>yesName of the organization.
--street <STREET>yesStreet and number of the billing address.
--city <CITY>yesCity of the billing address.
--postal-code <POSTAL_CODE>yesPostal code of the billing address.
--country <COUNTRY>yesCountry of the billing address.
--invoice-email <INVOICE_EMAIL>yesEmail address invoices are sent to.
--contact-person <CONTACT_PERSON>yesPerson invoices are addressed to.
--vat-id <VAT_ID>noVAT identification number, if any.

list-organisations

List accessible organisations.

terminal
origin admin list-organisations

This command takes no options.

get-organisation

Get an organization by its id or URN.

terminal
origin admin get-organisation --id <ID>
OptionRequiredDescription
--id <ID>yesId of the organisation.

create-project

Create a project in an organization.

terminal
origin admin create-project [OPTIONS] --name <NAME> --org-id <ORG_ID>
OptionRequiredDescription
--name <NAME>yesName of the project.
--id-prefix <ID_PREFIX>noPrefix of the project id.
--org-id <ORG_ID>yesID of the organisation.

list-projects

List accessible projects.

terminal
origin admin list-projects --org-id <ORG_ID>
OptionRequiredDescription
--org-id <ORG_ID>yesID of the organisation.

get-project

Get a project by its id or URN.

terminal
origin admin get-project --org-id <ORG_ID> --id <ID>
OptionRequiredDescription
--org-id <ORG_ID>yesID of the organisation.
--id <ID>yesId of the project. Use with org-id.

update-organisation

Rename an organisation.

terminal
origin admin update-organisation --org-id <ORG_ID> --name <NAME>
OptionRequiredDescription
--org-id <ORG_ID>yesID of the organisation.
--name <NAME>yesNew name.

delete-organisation

Delete an organisation. Refuses unless it has zero projects.

terminal
origin admin delete-organisation --org-id <ORG_ID>
OptionRequiredDescription
--org-id <ORG_ID>yesID of the organisation.

update-project

Rename a project.

terminal
origin admin update-project --org-id <ORG_ID> --id <ID> --name <NAME>
OptionRequiredDescription
--org-id <ORG_ID>yesID of the organisation.
--id <ID>yesId of the project.
--name <NAME>yesNew name.

delete-project

Delete a project. Refuses while it still owns any resource (instance, image, key pair, volume, snapshot, NAT gateway, Floating IP, VPC) and names each kind left

terminal
origin admin delete-project --org-id <ORG_ID> --id <ID>
OptionRequiredDescription
--org-id <ORG_ID>yesID of the organisation.
--id <ID>yesId of the project.

profile

Show the values stored in the local CLI profile.

terminal
origin config profile

This command takes no options.

profile-set

Set a value in the local CLI profile.

terminal
origin config profile-set <KEY> <VALUE>

This command takes no options.