---
title: "POST /reporting/repositories"
method: POST
path: "/reporting/repositories"
tags: ["Reports"]
---

# POST /reporting/repositories

`POST /reporting/repositories`

Create new reports repository resource.
The newly created reports repository will be set to the
`configuring` status till the validation of the contained templates is finalized.
An asynchronous task will be started to validate and configure the report templates contained
within the reports git repository.

## Request body

- ReportingReportsRepositoryCreate — Repository Create Request. Is used to represent input object to request repository creation. You need to provide `git` object with repository details.
  - `git` ReportingGitInfoCreate, required — Git Info. Is used to represent git repository information while adding new repository. You need to provide `url` and `tag` parameters as input data. Optionally you can provide `auth` if your repository requires authentication.
    - `url` string, uri, required
    - `tag` string, required
    - `auth` ReportingGitCredentials — Git Credentials. Is used to represent input object to request git tags. You need to provide `username` and `password` to your git repository as input data.
      - `username` string, nullable
      - `password` string, nullable

## Response `201`

- ReportingReportsRepository — Repository. Is used to represent reports repository.
  - `id` string
  - `name` string, nullable
  - `description` string, nullable
  - `version` string, nullable
  - `language` 'python', nullable
  - `repository_type` 'system' | 'custom'
  - `revision` integer
  - `git` ReportingGitInfo, required — Git Info. Is used to represent git repository information
    - `url` string, uri, required
    - `tag` string, required
    - `commit` string, nullable
    - `auth` ReportingGitCredentials — Git Credentials. Is used to represent input object to request git tags. You need to provide `username` and `password` to your git repository as input data.
      - `username` string, nullable
      - `password` string, nullable
  - `status` 'configuring' | 'ready' | 'failed'
  - `notes` string, nullable
  - `stats` ReportingRepoStats, required — Repository Stats. Is used to represent statistics about repository. `templates_count` -- amount of templates registered for this repository, `monthly_executions` -- amount of executions in current month, `total_executions` -- amount of all executions.
    - `templates_count` integer
    - `monthly_executions` integer
    - `total_executions` integer
  - `events` object
    - `created` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `updated` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
  - `owner` ReportingAccountReference, required
    - `id` string
    - `name` string, required

## Other responses

- `400`

---

[API](https://skmtc.net/cloudblue/apis/cloudblue-connect-api.md) · [All operations](https://skmtc.net/cloudblue/apis/cloudblue-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudblue/cloudblue-connect-api/revisions/0421d2a97c52/schema)