---
title: "git.issue@1 · OpenVibe.Services"
canonical: "https://openvibe.services/docs/contracts/git.issue"
updated: null
---

# git.issue@1 · OpenVibe.Services

HTML: [git.issue@1 · OpenVibe.Services](https://openvibe.services/docs/contracts/git.issue)

# GitIssue `git.issue@1`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0).

- Version: 1.0.0
- Owner: git
- Visibility: public
- Status: active
- Compatibility: backward
- Schema: [`https://openvibe.network/contracts/git/issue.v1.json`](/docs/contracts/git.issue.json)

Git G2 issue metadata. Community thread is hidden; Git authorizes repository access. PostgreSQL bigint numbers may be decimal strings.

## Fields

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| `id` | string | yes |  | - `pattern ^iss_[0-9A-HJKMNP-TV-Z]{26}$` |
| `number` | integer \| string | yes |  | - `pattern ^[1-9][0-9]*$`<br>- `minimum 1` |
| `repo_id` | string | yes |  |  |
| `title` | string | yes |  | - `minLength 1`<br>- `maxLength 200` |
| `body` | string | yes |  | - `maxLength 10000` |
| `author` | string | yes |  |  |
| `state` | enum | yes |  | - `one of "open", "closed"` |
| `thread_id` | string \| null | yes |  |  |
| `created_at` | string | yes |  | - `format date-time` |
| `closed_at` | string \| null | yes |  | - `format date-time` |
| `labels` | array of string | yes |  | - `maxItems 20`<br>- `unique items`<br>- `items: pattern ^[A-Za-z0-9_ -]{1,40}$` |

## Examples

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

 Valid: open

~~~~
{
  "id": "iss_00000000000000000000000000",
  "number": 1,
  "repo_id": "repo_00000000000000000000000000",
  "title": "Review a change",
  "body": "Details",
  "author": "usr_00000000000000000000000000",
  "state": "open",
  "thread_id": null,
  "created_at": "2026-11-09T12:00:00Z",
  "closed_at": null,
  "labels": [
    "docs"
  ]
}
~~~~

Rejected: state

~~~~
{
  "id": "iss_00000000000000000000000000",
  "number": 1,
  "repo_id": "repo_00000000000000000000000000",
  "title": "Review a change",
  "body": "Details",
  "author": "usr_00000000000000000000000000",
  "state": "unknown",
  "thread_id": null,
  "created_at": "2026-11-09T12:00:00Z",
  "closed_at": null,
  "labels": [
    "docs"
  ]
}
~~~~

## Validate

~~~~
const contracts = require('openvibe-contracts');
contracts.validate('git.issue@1', value);   // { valid, errors: [{ path, message }] }
~~~~