Skip to Content
kosemdocs
ReferenceAPIAccess profiles

Create access profile in organization

Creates an access profile backed by a connection. Creating an access profile takes connections.connections.use on its connection. An organization access profile shared with projects materializes read-only project copies automatically.

POST
/v1/organizations/{organization}/accessProfiles

Creates an access profile backed by a connection.

Creating an access profile takes connections.connections.use on its connection. An organization access profile shared with projects materializes read-only project copies automatically.

Authorization

bearer
headerAuthorizationBearer <token>

An access token, or an API key.

Path Parameters

organization*string

The organization's ID.

Match^org_[0-7][0-9a-hjkmnp-tv-z]{25}$

Request Body

application/json
  1. body
alias*string

Short name unique in its organization or project.

Match^[a-z][a-z0-9_]*(/[a-z0-9_]+)*$
Length1 <= length <= 128
availability?

For an organization access profile: projects to share it with.

config*

Provider-specific ceiling scope.

connection*string

Resource name of the connection this profile issues credentials through. Takes connections.connections.use.

description?string

What this access profile is for.

Lengthlength <= 500

Response Body

Created

application/json
  1. response
alias*string

Short name unique within its organization or project, such as github/kosem or gcp/preview_viewer.

availability*

For an organization's access profile: projects it is shared with. Shared profiles materialize read-only project copies automatically.

config*

Provider-specific ceiling scope for issued credentials.

connection*string

Resource name of the backing connection.

createTime*string

When the access profile was created.

Formatdate-time
description*string

What this access profile is for.

etag*string

Opaque revision tag for optimistic concurrency on updates.

name*string

Resource name: organizations/{organization_id}/accessProfiles/{profile_id} or projects/{project_id}/accessProfiles/{profile_id}.

provider*string

Provider type, such as providers/github, providers/google-cloud or providers/aws.

source?string

For a shared project copy: resource name of the organization access profile it mirrors.

state*string

Whether credentials can be issued through this profile.

Value in"ACTIVE""NEEDS_ATTENTION"
stateReason*string

Why the profile needs attention.

updateTime*string

When the access profile was last updated.

Formatdate-time
Example Request
curl -X POST 'https://api.kosem.ai/v1/organizations/string/accessProfiles' \
  -H 'Content-Type: application/json' \
  -d '{
  "alias": "string",
  "config": {
    "property1": null,
    "property2": null
  },
  "connection": "string"
}'
Example Response
{
  "alias": "string",
  "availability": {
    "allProjects": true,
    "projects": [
      "string"
    ]
  },
  "config": {
    "property1": null,
    "property2": null
  },
  "connection": "string",
  "createTime": "2019-08-24T14:15:22Z",
  "description": "string",
  "etag": "string",
  "name": "string",
  "provider": "string",
  "source": "string",
  "state": "ACTIVE",
  "stateReason": "string",
  "updateTime": "2019-08-24T14:15:22Z"
}