Repository

Lookup a repository and associated information.

repository

Query:repository Fetch the details of one of your repositories.

Arguments

Field	Type	Description
name	String!	The name of the repository to lookup.
login	String!	The login or username of the account under which the repository exists.
vcsProvider	VCSProvider!	VCS Provider of the account.

Sample Request

query {
  repository(
      name:"demo-go",
      login:"cyberdyne",
      vcsProvider:GITHUB
    ) {
    name
    defaultBranch
    dsn
    isPrivate
    analysisRuns {
      edges {
        node {
          runUid
        }
      }
    }
  }
}

Sample Response

{
  "data": {
    "repository": {
      "name": "demo-go",
      "defaultBranch": "master",
      "dsn": "https://[email protected]",
      "isPrivate": true,
      "analysisRuns": {
        "edges": [
          {
            "node": {
              "runUid": "5d821174-04vf-4214-b56d-ced0a7ca209e"
            }
          },
          {
            "node": {
              "runUid": "6ff1cdb8-9abe-4307-a177-4b9f8d3ba639"
            }
          },
        ]
      }
    }
  }
}

regenerateRepositoryDSN

Mutation:regenerateRepositoryDSN Regenerate a repository's DSN.

Arguments

Field	Type	Description
input	RegenerateRepositoryDSNInput!	Input for `RegenerateRepositoryDSN` mutation.

Sample Request

mutation ($input: RegenerateRepositoryDSNInput!) {
  regenerateRepositoryDSN(input: $input) {
    dsn
  }
}

variables = {
  "input": {
    "repositoryId": "VHJhbnNmb3JtZXI6bGp6a3d6"
  }
}

Sample Response

{
  "regenerateRepositoryDSN": {
    "dsn": "https://[email protected]"
  }
}

updateRepositoryDefaultBranch

Mutation:updateRepositoryDefaultBranch Update a repository's default branch for baseline. If the repository is activated, this action will trigger a new analysis. Only available to users with WRITE permission on the repository.

Arguments

Field	Type	Description
input	UpdateRepositoryDefaultBranchInput!	Input for `UpdateRepositoryDefaultBranch` mutation

Sample Request

mutation ($input: UpdateRepositoryDefaultBranchInput!) {
  updateRepositoryDefaultBranch(input: $input) {
    ok
    repository {
      defaultBranchName
    }
  }
}

variables = {
  "input": {
    "id": "VHJhbnNmb3JtZXI6bGp6a3d6",
    "defaultBranchName": "add-awesomeness"
  }
}

Sample Response

{  
  "updateRepositoryDefaultBranch": {
    "ok": true,
    "repository": {"defaultBranchName": "add-awesomeness"}
  }  
}

Objects

Repository

Field	Type	Description
name	String!	The name of this repository.
latestCommitOid	String	Object ID of the latest commit on the default branch.
isPrivate	Boolean!	Repository visibility on the VCS provider.
isActivated	Boolean!	Repository activation status.
id	ID!	The ID of the object.
account	Account!	The account under which this repository exists.
analysisRuns	AnalysisRunConnection	Past analysis runs for the repository
offset	Int
before	String
after	String
first	Int
last	Int
configJson	JSON	The `.deepsource.toml` config of the repository represented as a JSON object.
defaultBranch	String	The default base branch of the repository on DeepSource.
dsn	String	The DSN value for this repository.
enabledAnalyzers	AnalyzerConnection	The analyzers enabled in this repository.
offset	Int
before	String
after	String
first	Int
last	Int
issues	RepositoryIssueConnection	Get all issues raised in the default branch of this repository. Specifying a path would only return those issues whose occurrences are present in the file at path.
path	String	Show issues for this path only.
offset	Int
before	String
after	String
first	Int
last	Int
report	Report!	A report associated with this repository.
key	ReportKey!	The key of the report to fetch.
vcsProvider	VCSProvider!	VCS Provider of the repository.
vcsUrl	String!	URL of the repository on the VCS.
metrics	RepositoryMetric!!	List of all DeepSource metrics.
shortcodeIn	[MetricShortcode]	List of metric shortcodes to filter on.

RepositoryIssue

Field	Type	Description
id	ID!	The ID of the object.
issue	Issue!	Definition of the issue that has been raised.
occurrences	OccurrenceConnection	All occurrences of this issue in the default branch.
offset	Int
before	String
after	String
first	Int
last	Int
repository	Repository!	The repository for which this issue has been raised.

RepositoryIssueConnection

Field	Type	Description
pageInfo	PageInfo!	Pagination data for this connection.
edges	RepositoryIssueEdge!	Contains the nodes in this connection.
totalCount	Int

RepositoryIssueEdge

A Relay edge containing a RepositoryIssue and its cursor.

Field	Type	Description
node	RepositoryIssue	The item at the end of the edge.
cursor	String!	A cursor for use in pagination.

RepositoryConnection

Field	Type	Description
pageInfo	PageInfo!	Pagination data for this connection.
edges	[RepositoryEdge]!	Contains the nodes in this connection.
totalCount	Int

RepositoryEdge

A Relay edge containing a Repository and its cursor.

Field	Type	Description
node	Repository	The item at the end of the edge.
cursor	String!	A cursor for use in pagination.

RegenerateRepositoryDSNInput

Input for the regenerateRepositoryDSN mutation.

Field	Type	Description
repositoryId	ID!	GraphQL node ID of the repository.

RegenerateRepositoryDSNPayload

Payload for the regenerateRepositoryDSN mutation.

Field	Type	Description
dsn	String!	The new DSN for the repository.

UpdateRepositoryDefaultBranchInput

Input for the UpdateRepositoryDefaultBranch mutation.

Field	Type	Description
id	ID!	GraphQL node ID of the repository.
defaultBranchName	String!	Default branch for analysis on the repository.

UpdateRepositoryDefaultBranchPayload

Payload for the UpdateRepositoryDefaultBranch mutation.

Field	Type	Description
ok	Boolean!	Whether the operation was successful.
repository	Repository!	`Repository` type.