@templmf/temp-solf-lmf 0.0.109 → 0.0.111

package/gitlab-foss-8-17-stable/doc/api/system_hooks.md

@@ -1,146 +0,0 @@
-# System hooks
-
-All methods require administrator authorization.
-
-The URL endpoint of the system hooks can also be configured using the UI in
-the admin area under **Hooks** (`/admin/hooks`).
-
-Read more about [system hooks](../system_hooks/system_hooks.md).
-
-## List system hooks
-
-Get a list of all system hooks.
-
----
-
-```
-GET /hooks
-```
-
-Example request:
-
-```bash
-curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/hooks
-```
-
-Example response:
-
-```json
-[
-  {
-    "id":1,
-    "url":"https://gitlab.example.com/hook",
-    "created_at":"2016-10-31T12:32:15.192Z",
-    "push_events":true,
-    "tag_push_events":false,
-    "enable_ssl_verification":true
-  }
-]
-```
-
-## Add new system hook
-
-Add a new system hook.
-
----
-
-```
-POST /hooks
-```
-
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `url` | string | yes | The hook URL |
-| `token` | string | no | Secret token to validate received payloads; this will not be returned in the response |
-| `push_events` | boolean |  no | When true, the hook will fire on push events |
-| `tag_push_events` | boolean | no | When true, the hook will fire on new tags being pushed |
-| `enable_ssl_verification` | boolean | no | Do SSL verification when triggering the hook |
-
-Example request:
-
-```bash
-curl --request POST --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/hooks?url=https://gitlab.example.com/hook"
-```
-
-Example response:
-
-```json
-[
-  {
-    "id":1,
-    "url":"https://gitlab.example.com/hook",
-    "created_at":"2016-10-31T12:32:15.192Z",
-    "push_events":true,
-    "tag_push_events":false,
-    "enable_ssl_verification":true
-  }
-]
-```
-
-## Test system hook
-
-```
-GET /hooks/:id
-```
-
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id` | integer | yes | The ID of the hook |
-
-Example request:
-
-```bash
-curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/hooks/2
-```
-
-Example response:
-
-```json
-{
-   "project_id" : 1,
-   "owner_email" : "example@gitlabhq.com",
-   "owner_name" : "Someone",
-   "name" : "Ruby",
-   "path" : "ruby",
-   "event_name" : "project_create"
-}
-```
-
-## Delete system hook
-
-Deletes a system hook.
-
----
-
-```
-DELETE /hooks/:id
-```
-
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id` | integer | yes | The ID of the hook |
-
-Example request:
-
-```bash
-curl --request DELETE --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/hooks/2
-```
-
-Example response:
-
-```json
-{
-   "note_events" : false,
-   "project_id" : null,
-   "enable_ssl_verification" : true,
-   "url" : "https://gitlab.example.com/hook",
-   "updated_at" : "2015-11-04T20:12:15.931Z",
-   "issues_events" : false,
-   "merge_requests_events" : false,
-   "created_at" : "2015-11-04T20:12:15.931Z",
-   "service_id" : null,
-   "id" : 2,
-   "push_events" : true,
-   "tag_push_events" : false
-}
-```

package/gitlab-foss-8-17-stable/doc/api/tags.md

@@ -1,191 +0,0 @@
-# Tags
-
-## List project repository tags
-
-Get a list of repository tags from a project, sorted by name in reverse
-alphabetical order. This endpoint can be accessed without authentication if the
-repository is publicly accessible.
-
-```
-GET /projects/:id/repository/tags
-```
-
-Parameters:
-
-- `id` (required) - The ID of a project
-
-```json
-[
-  {
-    "commit": {
-      "author_name": "John Smith",
-      "author_email": "john@example.com",
-      "authored_date": "2012-05-28T04:42:42-07:00",
-      "committed_date": "2012-05-28T04:42:42-07:00",
-      "committer_name": "Jack Smith",
-      "committer_email": "jack@example.com",
-      "id": "2695effb5807a22ff3d138d593fd856244e155e7",
-      "message": "Initial commit",
-      "parents_ids": [
-        "2a4b78934375d7f53875269ffd4f45fd83a84ebe"
-      ]
-    },
-    "release": {
-      "tag_name": "1.0.0",
-      "description": "Amazing release. Wow"
-    },
-    "name": "v1.0.0",
-    "message": null
-  }
-]
-```
-
-## Get a single repository tag
-
-Get a specific repository tag determined by its name. This endpoint can be
-accessed without authentication if the repository is publicly accessible.
-
-```
-GET /projects/:id/repository/tags/:tag_name
-```
-
-Parameters:
-
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id` | integer | yes | The ID of a project |
-| `tag_name` | string | yes | The name of the tag |
-
-```bash
-curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/repository/tags/v1.0.0
-```
-
-Example Response:
-
-```json
-{
-  "name": "v5.0.0",
-  "message": null,
-  "commit": {
-    "id": "60a8ff033665e1207714d6670fcd7b65304ec02f",
-    "message": "v5.0.0\n",
-    "parent_ids": [
-      "f61c062ff8bcbdb00e0a1b3317a91aed6ceee06b"
-    ],
-    "authored_date": "2015-02-01T21:56:31.000+01:00",
-    "author_name": "Arthur Verschaeve",
-    "author_email": "contact@arthurverschaeve.be",
-    "committed_date": "2015-02-01T21:56:31.000+01:00",
-    "committer_name": "Arthur Verschaeve",
-    "committer_email": "contact@arthurverschaeve.be"
-  },
-  "release": null
-}
-```
-
-## Create a new tag
-
-Creates a new tag in the repository that points to the supplied ref.
-
-```
-POST /projects/:id/repository/tags
-```
-
-Parameters:
-
-- `id` (required) - The ID of a project
-- `tag_name` (required) - The name of a tag
-- `ref` (required) - Create tag using commit SHA, another tag name, or branch name.
-- `message` (optional) - Creates annotated tag.
-- `release_description` (optional) - Add release notes to the git tag and store it in the GitLab database.
-
-```json
-{
-  "commit": {
-    "author_name": "John Smith",
-    "author_email": "john@example.com",
-    "authored_date": "2012-05-28T04:42:42-07:00",
-    "committed_date": "2012-05-28T04:42:42-07:00",
-    "committer_name": "Jack Smith",
-    "committer_email": "jack@example.com",
-    "id": "2695effb5807a22ff3d138d593fd856244e155e7",
-    "message": "Initial commit",
-    "parents_ids": [
-      "2a4b78934375d7f53875269ffd4f45fd83a84ebe"
-    ]
-  },
-  "release": {
-    "tag_name": "1.0.0",
-    "description": "Amazing release. Wow"
-  },
-  "name": "v1.0.0",
-  "message": null
-}
-```
-The message will be `nil` when creating a lightweight tag otherwise
-it will contain the annotation.
-
-In case of an error,
-status code `405` with an explaining error message is returned.
-
-## Delete a tag
-
-Deletes a tag of a repository with given name.
-
-```
-DELETE /projects/:id/repository/tags/:tag_name
-```
-
-Parameters:
-
-- `id` (required) - The ID of a project
-- `tag_name` (required) - The name of a tag
-
-```json
-{
-  "tag_name": "v4.3.0"
-}
-```
-
-## Create a new release
-
-Add release notes to the existing git tag. If there
-already exists a release for the given tag, status code `409` is returned.
-
-```
-POST /projects/:id/repository/tags/:tag_name/release
-```
-
-Parameters:
-
-- `id` (required) - The ID of a project
-- `tag_name` (required) - The name of a tag
-- `description` (required) - Release notes with markdown support
-
-```json
-{
-  "tag_name": "1.0.0",
-  "description": "Amazing release. Wow"
-}
-```
-
-## Update a release
-
-Updates the release notes of a given release.
-
-```
-PUT /projects/:id/repository/tags/:tag_name/release
-```
-
-Parameters:
-
-- `id` (required) - The ID of a project
-- `tag_name` (required) - The name of a tag
-- `description` (required) - Release notes with markdown support
-
-```json
-{
-  "tag_name": "1.0.0",
-  "description": "Amazing release. Wow"
-}
-```