---
title: "POST /organization/{organizationId}/vcs"
method: POST
path: "/organization/{organizationId}/vcs"
tags: ["vcs"]
---

# POST /organization/{organizationId}/vcs

`POST /organization/{organizationId}/vcs`

## Request

- Base URL: `https://4014930676-files.gitbook.io/api/v1`
- URL: `https://4014930676-files.gitbook.io/api/v1/organization/{organizationId}/vcs`
- Auth: none declared
- TypeScript: <https://skmtc.dev/terrakube/apis/elide-service/docs/organization/:organizationId/vcs/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates an item of type vcs and adds it to vcs

## Request body

- object
  - `data` Vcs
    - `type` string: Create Permissions : (team manage vcs) Delete Permissions : (team manage vcs)
    - `id` string
    - `attributes` object
      - `accessToken` string: Read Permissions : (read access token) Update Permissions : (team manage vcs)
      - `clientId` string: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
      - `clientSecret` string: Read Permissions : (read vcs secret) Update Permissions : (team manage vcs)
      - `createdBy` string: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
      - `createdDate` string, date-time: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
      - `description` string: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
      - `name` string: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
      - `status` 'PENDING' | 'COMPLETED' | 'ERROR': Read Permissions : (team view vcs) Update Permissions : (user is a super service)
      - `updatedBy` string: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
      - `updatedDate` string, date-time: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
      - `vcsType` 'GITHUB' | 'GITLAB' | 'BITBUCKET' | 'AZURE_DEVOPS' | 'PUBLIC': Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
    - `relationships` object
      - `organization` object: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
        - `id` string
        - `type` 'organization'

## Response `201`

Successful response

- object
  - `data` Vcs
    - `type` string: Create Permissions : (team manage vcs) Delete Permissions : (team manage vcs)
    - `id` string
    - `attributes` object
      - `accessToken` string: Read Permissions : (read access token) Update Permissions : (team manage vcs)
      - `clientId` string: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
      - `clientSecret` string: Read Permissions : (read vcs secret) Update Permissions : (team manage vcs)
      - `createdBy` string: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
      - `createdDate` string, date-time: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
      - `description` string: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
      - `name` string: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
      - `status` 'PENDING' | 'COMPLETED' | 'ERROR': Read Permissions : (team view vcs) Update Permissions : (user is a super service)
      - `updatedBy` string: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
      - `updatedDate` string, date-time: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
      - `vcsType` 'GITHUB' | 'GITLAB' | 'BITBUCKET' | 'AZURE_DEVOPS' | 'PUBLIC': Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
    - `relationships` object
      - `organization` object: Read Permissions : (team view vcs) Update Permissions : (team manage vcs)
        - `id` string
        - `type` 'organization'

---

[API](https://skmtc.dev/terrakube/apis/elide-service.md) - [All operations](https://skmtc.dev/terrakube/apis/elide-service/llms.txt) - [OpenAPI document](https://skmtc.dev/terrakube/apis/elide-service/revisions/e7891deb8c02?raw)