Redocly Scout agent (1.0)

Scout Worker API.

Download OpenAPI description
Languages
Servers
Mock server
https://redocly.com/_mock/docs/realm/scout/agent-api/openapi/
https://redocly.com/{host}/

Health

Operations related to health checks.

Operations

Webhooks

Operations related to incoming git webhooks.

Operations

Create GitHub webhook event

Request

Registers and start process GitHub repository event. For now only push and create pull request events are supported.

Bodyapplication/jsonrequired
One of:
refstringrequired

The full git ref that is pushed. Example: refs/heads/main or refs/tags/v3.14.1.

beforestringrequired

The SHA of the most recent commit on ref before the push.

afterstringrequired

The SHA of the most recent commit on ref after the push.

createdbooleanrequired

Whether this push created the ref.

deletedbooleanrequired

Whether this push deleted the ref.

forcedbooleanrequired

Whether this push is a force push of the ref.

base_refstring or nullrequired
comparestringrequired

URL that shows the changes in this ref update, from the before commit to the after commit. For a newly created ref that is directly based on the default branch, this is the comparison between the head of the default branch and the after commit. Otherwise, this shows all commits until the after commit.

commitsArray of objects(Commit)required

An array of commit objects describing the pushed commits. (Pushed commits are all commits that are included in the compare between the before commit and the after commit.) The array includes a maximum of 20 commits. If necessary, you can use the Commits API to fetch additional commits. This limit is applied to timeline events only and isn't applied to webhook deliveries.

commits[].​idstringrequired
commits[].​tree_idstringrequired
commits[].​distinctbooleanrequired

Whether this commit is distinct from any that have been pushed before.

commits[].​messagestringrequired

The commit message.

commits[].​timestampstring(date-time)required

The ISO 8601 timestamp of the commit.

commits[].​urlstring(uri)required

URL that points to the commit API resource.

commits[].​authorobject(committer)required

Metaproperties for Git author/committer information.

commits[].​author.​namestringrequired

The git author's name.

commits[].​author.​emailstring or nullrequired

The git author's email address.

One of:

The git author's email address.

string(email)

The git author's email address.

commits[].​author.​datestring(date-time)
commits[].​author.​usernamestring
commits[].​committerobject(committer)required

Metaproperties for Git author/committer information.

commits[].​committer.​namestringrequired

The git author's name.

commits[].​committer.​emailstring or nullrequired

The git author's email address.

One of:

The git author's email address.

string(email)

The git author's email address.

commits[].​committer.​datestring(date-time)
commits[].​committer.​usernamestring
commits[].​addedArray of stringsrequired

An array of files added in the commit.

commits[].​modifiedArray of stringsrequired

An array of files modified by the commit.

commits[].​removedArray of stringsrequired

An array of files removed in the commit.

head_commitCommit (object) or nullrequired

For pushes where after is or points to a commit object, an expanded representation of that commit. For pushes where after refers to an annotated tag object, an expanded representation of the commit pointed to by the annotated tag.

One of:

For pushes where after is or points to a commit object, an expanded representation of that commit. For pushes where after refers to an annotated tag object, an expanded representation of the commit pointed to by the annotated tag.

head_commit.​idstringrequired
head_commit.​tree_idstringrequired
head_commit.​distinctbooleanrequired

Whether this commit is distinct from any that have been pushed before.

head_commit.​messagestringrequired

The commit message.

head_commit.​timestampstring(date-time)required

The ISO 8601 timestamp of the commit.

head_commit.​urlstring(uri)required

URL that points to the commit API resource.

head_commit.​authorobject(committer)required

Metaproperties for Git author/committer information.

head_commit.​author.​namestringrequired

The git author's name.

head_commit.​author.​emailstring or nullrequired

The git author's email address.

One of:

The git author's email address.

string(email)

The git author's email address.

head_commit.​author.​datestring(date-time)
head_commit.​author.​usernamestring
head_commit.​committerobject(committer)required

Metaproperties for Git author/committer information.

head_commit.​committer.​namestringrequired

The git author's name.

head_commit.​committer.​emailstring or nullrequired

The git author's email address.

One of:

The git author's email address.

string(email)

The git author's email address.

head_commit.​committer.​datestring(date-time)
head_commit.​committer.​usernamestring
head_commit.​addedArray of stringsrequired

An array of files added in the commit.

head_commit.​modifiedArray of stringsrequired

An array of files modified by the commit.

head_commit.​removedArray of stringsrequired

An array of files removed in the commit.

repositoryobject(repository)required

A git repository.

repository.​idintegerrequired

Unique identifier of the repository.

repository.​node_idstringrequired

The GraphQL identifier of the repository.

repository.​namestringrequired

The name of the repository.

repository.​full_namestringrequired

The full, globally unique, name of the repository.

repository.​privatebooleanrequired

Whether the repository is private or public.

repository.​ownerobject(user)required
repository.​owner.​loginstringrequired
repository.​owner.​idintegerrequired
repository.​owner.​node_idstringrequired
repository.​owner.​namestring
repository.​owner.​emailstring or null
repository.​owner.​avatar_urlstring(uri)required
repository.​owner.​gravatar_idstringrequired
repository.​owner.​urlstring(uri)required
repository.​owner.​html_urlstring(uri)required
repository.​owner.​followers_urlstring(uri)required
repository.​owner.​following_urlstring(uri-template)required
repository.​owner.​gists_urlstring(uri-template)required
repository.​owner.​starred_urlstring(uri-template)required
repository.​owner.​subscriptions_urlstring(uri)required
repository.​owner.​organizations_urlstring(uri)required
repository.​owner.​repos_urlstring(uri)required
repository.​owner.​events_urlstring(uri-template)required
repository.​owner.​received_events_urlstring(uri)required
repository.​owner.​typestringrequired
Enum"Bot""User""Organization"
repository.​owner.​site_adminbooleanrequired
repository.​html_urlstring(uri)required

The URL to view the repository on GitHub.com.

repository.​descriptionstring or nullrequired

The repository description.

repository.​forkbooleanrequired

Whether the repository is a fork.

repository.​urlstring(uri)required

The URL to get more information about the repository from the GitHub API.

repository.​forks_urlstring(uri)required

The API URL to list the forks of the repository.

repository.​keys_urlstring(uri-template)required

A template for the API URL to get information about deploy keys on the repository.

repository.​collaborators_urlstring(uri-template)required

A template for the API URL to get information about collaborators of the repository.

repository.​teams_urlstring(uri)required

The API URL to list the teams on the repository.

repository.​hooks_urlstring(uri)required

The API URL to list the hooks on the repository.

repository.​issue_events_urlstring(uri-template)required

A template for the API URL to get information about issue events on the repository.

repository.​events_urlstring(uri)required

The API URL to list the events of the repository.

repository.​assignees_urlstring(uri-template)required

A template for the API URL to list the available assignees for issues in the repository.

repository.​branches_urlstring(uri-template)required

A template for the API URL to get information about branches in the repository.

repository.​tags_urlstring(uri)required

The API URL to get information about tags on the repository.

repository.​blobs_urlstring(uri-template)required

A template for the API URL to create or retrieve a raw Git blob in the repository.

repository.​git_tags_urlstring(uri-template)required

A template for the API URL to get information about Git tags of the repository.

repository.​git_refs_urlstring(uri-template)required

A template for the API URL to get information about Git refs of the repository.

repository.​trees_urlstring(uri-template)required

A template for the API URL to create or retrieve a raw Git tree of the repository.

repository.​statuses_urlstring(uri-template)required

A template for the API URL to get information about statuses of a commit.

repository.​languages_urlstring(uri)required

The API URL to get information about the languages of the repository.

repository.​stargazers_urlstring(uri)required

The API URL to list the stargazers on the repository.

repository.​contributors_urlstring(uri)required

A template for the API URL to list the contributors to the repository.

repository.​subscribers_urlstring(uri)required

The API URL to list the subscribers on the repository.

repository.​subscription_urlstring(uri)required

The API URL to subscribe to notifications for this repository.

repository.​commits_urlstring(uri-template)required

A template for the API URL to get information about commits on the repository.

repository.​git_commits_urlstring(uri-template)required

A template for the API URL to get information about Git commits of the repository.

repository.​comments_urlstring(uri-template)required

A template for the API URL to get information about comments on the repository.

repository.​issue_comment_urlstring(uri-template)required

A template for the API URL to get information about issue comments on the repository.

repository.​contents_urlstring(uri-template)required

A template for the API URL to get the contents of the repository.

repository.​compare_urlstring(uri-template)required

A template for the API URL to compare two commits or refs.

repository.​merges_urlstring(uri)required

The API URL to merge branches in the repository.

repository.​archive_urlstring(uri-template)required

A template for the API URL to download the repository as an archive.

repository.​downloads_urlstring(uri)required

The API URL to list the downloads on the repository.

repository.​issues_urlstring(uri-template)required

A template for the API URL to get information about issues on the repository.

repository.​pulls_urlstring(uri-template)required

A template for the API URL to get information about pull requests on the repository.

repository.​milestones_urlstring(uri-template)required

A template for the API URL to get information about milestones of the repository.

repository.​notifications_urlstring(uri-template)required

A template for the API URL to get information about notifications on the repository.

repository.​labels_urlstring(uri-template)required

A template for the API URL to get information about labels of the repository.

repository.​releases_urlstring(uri-template)required

A template for the API URL to get information about releases on the repository.

repository.​deployments_urlstring(uri)required

The API URL to list the deployments of the repository.

repository.​created_atinteger or stringrequired
One of:
integer
repository.​updated_atstring(date-time)required
repository.​pushed_atinteger or string or nullrequired
One of:
integer
repository.​git_urlstring(uri)required
repository.​ssh_urlstringrequired
repository.​clone_urlstring(uri)required
repository.​svn_urlstring(uri)required
repository.​homepagestring or nullrequired
repository.​sizeintegerrequired
repository.​stargazers_countintegerrequired
repository.​watchers_countintegerrequired
repository.​languagestring or nullrequired
repository.​has_issuesbooleanrequired

Whether issues are enabled.

Default true
repository.​has_projectsbooleanrequired

Whether projects are enabled.

Default true
repository.​has_downloadsbooleanrequired

Whether downloads are enabled.

Default true
repository.​has_wikibooleanrequired

Whether the wiki is enabled.

Default true
repository.​has_pagesbooleanrequired
repository.​forks_countintegerrequired
repository.​mirror_urlstring or null(uri)required
repository.​archivedbooleanrequired

Whether the repository is archived.

Default false
repository.​disabledboolean

Returns whether or not this repository is disabled.

repository.​open_issues_countintegerrequired
repository.​licenseLicense (object) or nullrequired
One of:
repository.​license.​keystringrequired
repository.​license.​namestringrequired
repository.​license.​spdx_idstringrequired
repository.​license.​urlstring or null(uri)required
repository.​license.​node_idstringrequired
repository.​forksintegerrequired
repository.​open_issuesintegerrequired
repository.​watchersintegerrequired
repository.​stargazersinteger
repository.​default_branchstringrequired

The default branch of the repository.

repository.​allow_squash_mergeboolean

Whether to allow squash merges for pull requests.

Default true
repository.​allow_merge_commitboolean

Whether to allow merge commits for pull requests.

Default true
repository.​allow_rebase_mergeboolean

Whether to allow rebase merges for pull requests.

Default true
repository.​allow_auto_mergeboolean

Whether to allow auto-merge for pull requests.

Default false
repository.​allow_forkingboolean

Whether to allow private forks.

repository.​allow_update_branchboolean
repository.​use_squash_pr_title_as_defaultboolean
repository.​is_templatebooleanrequired
repository.​web_commit_signoff_requiredbooleanrequired
repository.​topicsArray of stringsrequired
repository.​visibilitystringrequired
Enum"public""private""internal"
repository.​delete_branch_on_mergeboolean

Whether to delete head branches when pull requests are merged.

Default false
repository.​master_branchstring
repository.​permissionsobject
repository.​publicboolean
repository.​organizationstring
pusherobject(committer)required

Metaproperties for Git author/committer information.

pusher.​namestringrequired

The git author's name.

pusher.​emailstring or nullrequired

The git author's email address.

One of:

The git author's email address.

string(email)

The git author's email address.

pusher.​datestring(date-time)
pusher.​usernamestring
senderobject(user)required
sender.​loginstringrequired
sender.​idintegerrequired
sender.​node_idstringrequired
sender.​namestring
sender.​emailstring or null
sender.​avatar_urlstring(uri)required
sender.​gravatar_idstringrequired
sender.​urlstring(uri)required
sender.​html_urlstring(uri)required
sender.​followers_urlstring(uri)required
sender.​following_urlstring(uri-template)required
sender.​gists_urlstring(uri-template)required
sender.​starred_urlstring(uri-template)required
sender.​subscriptions_urlstring(uri)required
sender.​organizations_urlstring(uri)required
sender.​repos_urlstring(uri)required
sender.​events_urlstring(uri-template)required
sender.​received_events_urlstring(uri)required
sender.​typestringrequired
Enum"Bot""User""Organization"
sender.​site_adminbooleanrequired
installationobject(installation-lite)

Installation.

organizationobject(organization)
curl -i -X POST \
  https://redocly.com/_mock/docs/realm/scout/agent-api/openapi/webhooks/github \
  -H 'Content-Type: application/json' \
  -H 'x-hub-signature-256: YOUR_API_KEY_HERE' \
  -d '{
    "ref": "string",
    "before": "string",
    "after": "string",
    "created": true,
    "deleted": true,
    "forced": true,
    "base_ref": "string",
    "compare": "string",
    "commits": [
      {
        "id": "string",
        "tree_id": "string",
        "distinct": true,
        "message": "string",
        "timestamp": "2019-08-24T14:15:22Z",
        "url": "http://example.com",
        "author": {
          "name": "string",
          "email": "user@example.com",
          "date": "2019-08-24T14:15:22Z",
          "username": "string"
        },
        "committer": {
          "name": "string",
          "email": "user@example.com",
          "date": "2019-08-24T14:15:22Z",
          "username": "string"
        },
        "added": [
          "string"
        ],
        "modified": [
          "string"
        ],
        "removed": [
          "string"
        ]
      }
    ],
    "head_commit": {
      "id": "string",
      "tree_id": "string",
      "distinct": true,
      "message": "string",
      "timestamp": "2019-08-24T14:15:22Z",
      "url": "http://example.com",
      "author": {
        "name": "string",
        "email": "user@example.com",
        "date": "2019-08-24T14:15:22Z",
        "username": "string"
      },
      "committer": {
        "name": "string",
        "email": "user@example.com",
        "date": "2019-08-24T14:15:22Z",
        "username": "string"
      },
      "added": [
        "string"
      ],
      "modified": [
        "string"
      ],
      "removed": [
        "string"
      ]
    },
    "repository": {
      "id": 0,
      "node_id": "string",
      "name": "string",
      "full_name": "string",
      "private": true,
      "owner": {
        "login": "string",
        "id": 0,
        "node_id": "string",
        "name": "string",
        "email": "string",
        "avatar_url": "http://example.com",
        "gravatar_id": "string",
        "url": "http://example.com",
        "html_url": "http://example.com",
        "followers_url": "http://example.com",
        "following_url": "http://example.com/{endpoint}",
        "gists_url": "http://example.com/{endpoint}",
        "starred_url": "http://example.com/{endpoint}",
        "subscriptions_url": "http://example.com",
        "organizations_url": "http://example.com",
        "repos_url": "http://example.com",
        "events_url": "http://example.com/{endpoint}",
        "received_events_url": "http://example.com",
        "type": "Bot",
        "site_admin": true
      },
      "html_url": "http://example.com",
      "description": "string",
      "fork": true,
      "url": "http://example.com",
      "forks_url": "http://example.com",
      "keys_url": "http://example.com/{endpoint}",
      "collaborators_url": "http://example.com/{endpoint}",
      "teams_url": "http://example.com",
      "hooks_url": "http://example.com",
      "issue_events_url": "http://example.com/{endpoint}",
      "events_url": "http://example.com",
      "assignees_url": "http://example.com/{endpoint}",
      "branches_url": "http://example.com/{endpoint}",
      "tags_url": "http://example.com",
      "blobs_url": "http://example.com/{endpoint}",
      "git_tags_url": "http://example.com/{endpoint}",
      "git_refs_url": "http://example.com/{endpoint}",
      "trees_url": "http://example.com/{endpoint}",
      "statuses_url": "http://example.com/{endpoint}",
      "languages_url": "http://example.com",
      "stargazers_url": "http://example.com",
      "contributors_url": "http://example.com",
      "subscribers_url": "http://example.com",
      "subscription_url": "http://example.com",
      "commits_url": "http://example.com/{endpoint}",
      "git_commits_url": "http://example.com/{endpoint}",
      "comments_url": "http://example.com/{endpoint}",
      "issue_comment_url": "http://example.com/{endpoint}",
      "contents_url": "http://example.com/{endpoint}",
      "compare_url": "http://example.com/{endpoint}",
      "merges_url": "http://example.com",
      "archive_url": "http://example.com/{endpoint}",
      "downloads_url": "http://example.com",
      "issues_url": "http://example.com/{endpoint}",
      "pulls_url": "http://example.com/{endpoint}",
      "milestones_url": "http://example.com/{endpoint}",
      "notifications_url": "http://example.com/{endpoint}",
      "labels_url": "http://example.com/{endpoint}",
      "releases_url": "http://example.com/{endpoint}",
      "deployments_url": "http://example.com",
      "created_at": 0,
      "updated_at": "2019-08-24T14:15:22Z",
      "pushed_at": 0,
      "git_url": "http://example.com",
      "ssh_url": "string",
      "clone_url": "http://example.com",
      "svn_url": "http://example.com",
      "homepage": "string",
      "size": 0,
      "stargazers_count": 0,
      "watchers_count": 0,
      "language": "string",
      "has_issues": true,
      "has_projects": true,
      "has_downloads": true,
      "has_wiki": true,
      "has_pages": true,
      "forks_count": 0,
      "mirror_url": "http://example.com",
      "archived": false,
      "disabled": true,
      "open_issues_count": 0,
      "license": {
        "key": "string",
        "name": "string",
        "spdx_id": "string",
        "url": "http://example.com",
        "node_id": "string"
      },
      "forks": 0,
      "open_issues": 0,
      "watchers": 0,
      "stargazers": 0,
      "default_branch": "string",
      "allow_squash_merge": true,
      "allow_merge_commit": true,
      "allow_rebase_merge": true,
      "allow_auto_merge": false,
      "allow_forking": true,
      "allow_update_branch": true,
      "use_squash_pr_title_as_default": true,
      "is_template": true,
      "web_commit_signoff_required": true,
      "topics": [
        "string"
      ],
      "visibility": "public",
      "delete_branch_on_merge": false,
      "master_branch": "string",
      "permissions": {
        "pull": true,
        "push": true,
        "admin": true,
        "maintain": true,
        "triage": true
      },
      "public": true,
      "organization": "string"
    },
    "pusher": {
      "name": "string",
      "email": "user@example.com",
      "date": "2019-08-24T14:15:22Z",
      "username": "string"
    },
    "sender": {
      "login": "string",
      "id": 0,
      "node_id": "string",
      "name": "string",
      "email": "string",
      "avatar_url": "http://example.com",
      "gravatar_id": "string",
      "url": "http://example.com",
      "html_url": "http://example.com",
      "followers_url": "http://example.com",
      "following_url": "http://example.com/{endpoint}",
      "gists_url": "http://example.com/{endpoint}",
      "starred_url": "http://example.com/{endpoint}",
      "subscriptions_url": "http://example.com",
      "organizations_url": "http://example.com",
      "repos_url": "http://example.com",
      "events_url": "http://example.com/{endpoint}",
      "received_events_url": "http://example.com",
      "type": "Bot",
      "site_admin": true
    },
    "installation": {
      "id": 0,
      "node_id": "string"
    },
    "organization": {
      "login": "string",
      "id": 0,
      "node_id": "string",
      "url": "http://example.com",
      "html_url": "http://example.com",
      "repos_url": "http://example.com",
      "events_url": "http://example.com",
      "hooks_url": "http://example.com",
      "issues_url": "http://example.com",
      "members_url": "http://example.com/{endpoint}",
      "public_members_url": "http://example.com/{endpoint}",
      "avatar_url": "http://example.com",
      "description": "string"
    }
  }'

Responses

OK.

Bodyapplication/problem+json
messagestring

A human-readable message with more details.

Example: "Job created"
eventstring

Type of incoming webhook event.

Example: "push"
jobIdstring

Created Scout job ID.

Example: "sjob_01h4gev6h1j50ge5z3yn28ge5e"
Response
application/problem+json
{ "message": "Job created", "event": "push", "jobId": "sjob_01h4gev6h1j50ge5z3yn28ge5e" }

Create GitLab webhook event

Request

Register and start to process GitLab repository event. For now only push and create merge request events are supported.

Bodyapplication/jsonrequired
One of:
object_kindstringrequired

Type of webhook event data.

Example: "push"
beforestringrequired

The SHA of the most recent commit on ref before the push.

Example: "95790bf891e76fee5e1747ab589903a6a1f80f22"
afterstringrequired

The SHA of the most recent commit on ref after the push.

Example: "da1560886d4f094c3e6c9ef40349f7d38b5d27d7"
refstringrequired

The full git ref that is pushed. Example: refs/heads/main.

Example: "refs/heads/main"
checkout_shastringrequired

The SHA of the most recent commit on ref after the push.

Example: "da1560886d4f094c3e6c9ef40349f7d38b5d27d7"
user_idintegerrequired

Id of a gitlab user.

Example: 1
user_namestringrequired

Name of a gitlab user.

Example: "John"
user_usernamestringrequired

Nickname of a gitlab user.

Example: "john87"
user_emailstringrequired

Email of a gitlab user.

Example: "john87@email.com"
user_avatarstringrequired

User avatar url.

Example: "https://s.gravatar.com/avatar/d4c74594d841139328695756648b6bd6?s=8://s.gravatar.com/avatar/d4c74594d841139328695756648b6bd6?s=80"
project_idintegerrequired

Project id.

Example: 15
projectobject(project)required

GitLab Project details.

project.​idintegerrequired

Unique identifier of the project.

project.​namestringrequired

The name of the project.

project.​descriptionstringrequired

The description of the project.

project.​web_urlstring(uri)required

The URL to view the repository.

Example: "http://example.com/gitlabhq/gitlab-test"
project.​avatar_urlstring(uri)required

Repository avatar url.

Example: "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40\\u0026d=identicon"
project.​git_ssh_urlstring(uri)required

SSH url of a project.

Example: "git@example.com:gitlabhq/gitlab-test.git"
project.​git_http_urlstring(uri)required

Url of a project.

Example: "http://example.com/gitlabhq/gitlab-test.git"
project.​namespacestringrequired

Project namespace.

Example: "GitlabHQ"
project.​visibility_levelintegerrequired

Visibility level of a project.

Example: 20
project.​path_with_namespacestringrequired

Project path including namespace.

Example: "gitlabhq/gitlab-test"
project.​default_branchstringrequired

Project default branch.

Example: "develop"
project.​homepagestring(uri)required

Project homepage url.

Example: "http://example.com/gitlabhq/gitlab-test"
project.​urlstring(uri)required

Url of a project.

Example: "http://example.com/gitlabhq/gitlab-test.git"
project.​ssh_urlstring(uri)required

SSH url of a project.

Example: "git@example.com:gitlabhq/gitlab-test.git"
project.​http_urlstring(uri)required

Url of a project.

Example: "http://example.com/gitlabhq/gitlab-test.git"
repositoryobject(repository-2)required

GitLab repository details.

repository.​namestringrequired

The name of the project.

Example: "Awesome project"
repository.​urlstring(uri)required

Repository git url.

Example: "http://example.com/gitlabhq/awesome-project.git"
repository.​descriptionstringrequired

The description of the project.

Example: "Awesome project description."
repository.​homepagestring(uri)required

Project homepage url.

Example: "http://example.com/gitlabhq/awesome-project"
repository.​git_http_urlstring(uri)required

Git url of a project.

Example: "http://example.com/gitlabhq/gitlab-test.git"
repository.​git_ssh_urlstring(uri)required

SSH url of a project.

Example: "git@example.com:gitlabhq/awesome-project.git"
repository.​web_urlstring(uri)

The URL to view the repository.

Example: "http://example.com/gitlabhq/awesome-project"
repository.​avatar_urlstring(uri)

Avatar url of the repository.

Example: "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40\\u0026d=identicon"
repository.​visibility_levelintegerrequired

Visibility level of a project.

Example: 20
commitsArray of objects(Commit)required

An array of commit objects describing the pushed commits. (Pushed commits are all commits that are included in the compare between the before commit and the after commit.) The array includes a maximum of 20 commits.

commits[].​idstringrequired

Commit sha.

Example: "b6568db1bc1dcd7f8b4d5a946b0b91f9dacd7327"
commits[].​messagestringrequired

The commit message.

Example: "fixed readme"
commits[].​timestampstring(date-time)required

The ISO 8601 timestamp of the commit.

commits[].​urlstring(uri)required

URL that points to the commit API resource.

Example: "http://example.com/mike/diaspora/commit/da1560886d4f094c3e6c9ef40349f7d38b5d27d7"
commits[].​authorobject(author)required

Author details.

commits[].​author.​namestringrequired

Author name.

Example: "John"
commits[].​author.​emailstringrequired

Author email.

Example: "john.doe@email.com"
commits[].​addedArray of stringsrequired

An array of files added in the commit.

Example: ["CHANGELOG"]
commits[].​modifiedArray of stringsrequired

An array of files modified by the commit.

Example: ["app/controller/application.rb"]
commits[].​removedArray of stringsrequired

An array of files removed in the commit.

Example: ["app/controller/product.rb"]
total_commits_countintegerrequired

Contains the actual number of commits.

Example: 34
curl -i -X POST \
  https://redocly.com/_mock/docs/realm/scout/agent-api/openapi/webhooks/gitlab \
  -H 'Content-Type: application/json' \
  -H 'x-gitlab-token: YOUR_API_KEY_HERE' \
  -d '{
    "object_kind": "push",
    "before": "95790bf891e76fee5e1747ab589903a6a1f80f22",
    "after": "da1560886d4f094c3e6c9ef40349f7d38b5d27d7",
    "ref": "refs/heads/main",
    "checkout_sha": "da1560886d4f094c3e6c9ef40349f7d38b5d27d7",
    "user_id": 1,
    "user_name": "John",
    "user_username": "john87",
    "user_email": "john87@email.com",
    "user_avatar": "https://s.gravatar.com/avatar/d4c74594d841139328695756648b6bd6?s=8://s.gravatar.com/avatar/d4c74594d841139328695756648b6bd6?s=80",
    "project_id": 15,
    "project": {
      "id": 0,
      "name": "string",
      "description": "string",
      "web_url": "http://example.com/gitlabhq/gitlab-test",
      "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40\\u0026d=identicon",
      "git_ssh_url": "git@example.com:gitlabhq/gitlab-test.git",
      "git_http_url": "http://example.com/gitlabhq/gitlab-test.git",
      "namespace": "GitlabHQ",
      "visibility_level": 20,
      "path_with_namespace": "gitlabhq/gitlab-test",
      "default_branch": "develop",
      "homepage": "http://example.com/gitlabhq/gitlab-test",
      "url": "http://example.com/gitlabhq/gitlab-test.git",
      "ssh_url": "git@example.com:gitlabhq/gitlab-test.git",
      "http_url": "http://example.com/gitlabhq/gitlab-test.git"
    },
    "repository": {
      "name": "Awesome project",
      "url": "http://example.com/gitlabhq/awesome-project.git",
      "description": "Awesome project description.",
      "homepage": "http://example.com/gitlabhq/awesome-project",
      "git_http_url": "http://example.com/gitlabhq/gitlab-test.git",
      "git_ssh_url": "git@example.com:gitlabhq/awesome-project.git",
      "web_url": "http://example.com/gitlabhq/awesome-project",
      "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40\\u0026d=identicon",
      "visibility_level": 20
    },
    "commits": [
      {
        "id": "b6568db1bc1dcd7f8b4d5a946b0b91f9dacd7327",
        "message": "fixed readme",
        "timestamp": "2019-08-24T14:15:22Z",
        "url": "http://example.com/mike/diaspora/commit/da1560886d4f094c3e6c9ef40349f7d38b5d27d7",
        "author": {
          "name": "John",
          "email": "john.doe@email.com"
        },
        "added": [
          "CHANGELOG"
        ],
        "modified": [
          "app/controller/application.rb"
        ],
        "removed": [
          "app/controller/product.rb"
        ]
      }
    ],
    "total_commits_count": 34
  }'

Responses

OK.

Bodyapplication/problem+json
messagestring

A human-readable message with more details.

Example: "Job created"
eventstring

Type of incoming webhook event.

Example: "push"
jobIdstring

Created Scout job ID.

Example: "sjob_01h4gev6h1j50ge5z3yn28ge5e"
Response
application/problem+json
{ "message": "Job created", "event": "push", "jobId": "sjob_01h4gev6h1j50ge5z3yn28ge5e" }