Bitbucket Schema
graph LR
BitbucketProject -- CONTAINS --> BitbucketRepository
BitbucketWorkspace -- RESOURCE --> BitbucketProject
BitbucketWorkspace -- RESOURCE --> BitbucketRepository
BitbucketWorkspace -- RESOURCE --> BitbucketUserBitbucketProject
A Bitbucket Cloud project, grouping repositories within a workspace.
Properties
| Field | Index | Description |
|---|---|---|
| id | Yes | Bitbucket project UUID. |
| firstseen | Timestamp when a sync job first created this node. | |
| lastupdated | Yes | Timestamp of the last sync that observed this node. |
| created_on | Timestamp when Bitbucket created the project. | |
| description | Human-readable description of the project. | |
| is_private | Whether the project is private. | |
| key | Yes | Short project key, unique within the workspace. |
| link_html | URL for viewing the project in Bitbucket. | |
| name | Yes | Display name of the project. |
| updated_on | Timestamp of the project's most recent update. |
Relationships
(:BitbucketProject)-[:CONTAINS]->(:BitbucketRepository): Relationship from BitbucketRepository to BitbucketProject via CONTAINS. Only created when a repository has a project assigned - repos with no project simply omit the "project_id" key on their record.(:BitbucketWorkspace)-[:RESOURCE]->(:BitbucketProject): Sub-resource relationship from BitbucketProject to BitbucketWorkspace, used for cleanup scoping.
BitbucketRepository
A Bitbucket Cloud repository.
Every repository belongs to a workspace. Repositories also belong to a project, except legacy repositories created before Bitbucket introduced projects. Per-repository permissions, pull requests, and branch restrictions aren't ingested.
Ontology Mapping: This node uses the ontology label
CodeRepository.
Properties
| Field | Index | Description |
|---|---|---|
| id | Yes | Bitbucket repository UUID. |
| firstseen | Timestamp when a sync job first created this node. | |
| lastupdated | Yes | Timestamp of the last sync that observed this node. |
| clone_https | HTTPS clone URL for the repository. | |
| clone_ssh | SSH clone URL for the repository. | |
| created_on | Timestamp when Bitbucket created the repository. | |
| description | Human-readable description of the repository. | |
| full_name | Yes | Repository full name, in the form workspace/repo_slug. |
| is_private | Whether the repository is private. | |
| language | Primary programming language detected by Bitbucket. | |
| link_html | URL for viewing the repository in Bitbucket. | |
| mainbranch_name | Name of the repository's main branch. | |
| name | Yes | Display name of the repository. |
| project_key | Key of the Bitbucket project this repository belongs to, if any. | |
| scm | Source control system used by the repository, e.g. git. | |
| size | Repository size in bytes. | |
| slug | Yes | URL-friendly repository identifier. |
| updated_on | Timestamp of the repository's most recent update. |
Relationships
(:BitbucketProject)-[:CONTAINS]->(:BitbucketRepository): Relationship from BitbucketRepository to BitbucketProject via CONTAINS. Only created when a repository has a project assigned - repos with no project simply omit the "project_id" key on their record.(:BitbucketWorkspace)-[:RESOURCE]->(:BitbucketRepository): Sub-resource relationship from BitbucketRepository to BitbucketWorkspace. Repositories always belong to a workspace, even without a project, so the workspace is the cleanup-scoping root.
BitbucketUser
A current member of a Bitbucket Cloud workspace.
id is the Atlassian account ID, so a user who belongs to several synced
workspaces is one node with a RESOURCE relationship from each workspace.
Cartography doesn't map which users can access which repositories.
If Cartography can't list the members of any workspace in a run, it skips
BitbucketUser cleanup for every workspace in that run. Sync all of your
workspaces in a single run: when workspaces sync in separate runs, removing
a user from one workspace also removes the node and its other workspace
memberships until those workspaces sync again.
Ontology Mapping: This node uses the ontology label
UserAccount.
Properties
| Field | Index | Description |
|---|---|---|
| id | Yes | Stable Atlassian account ID for the user. |
| firstseen | Timestamp when a sync job first created this node. | |
| lastupdated | Yes | Timestamp of the last sync that observed this node. |
| avatar_url | URL of the user's avatar image. | |
| display_name | Yes | Display name of the user. |
| link_html | URL for viewing the user's profile in Bitbucket. | |
| nickname | Nickname of the user. | |
| uuid | Yes | Bitbucket user UUID. |
Relationships
(:User)-[:HAS_ACCOUNT]->(:BitbucketUser)(:BitbucketWorkspace)-[:RESOURCE]->(:BitbucketUser): Sub-resource relationship from BitbucketUser to BitbucketWorkspace, used for cleanup scoping.
BitbucketWorkspace
A Bitbucket Cloud workspace, the tenant boundary for projects, repositories, and members.
Cartography syncs only the workspaces listed in --bitbucket-workspaces.
If you remove a workspace from that list, its node and children stay in
the graph.
Ontology Mapping: This node uses the ontology label
Tenant.
Properties
| Field | Index | Description |
|---|---|---|
| id | Yes | Bitbucket workspace UUID. |
| firstseen | Timestamp when a sync job first created this node. | |
| lastupdated | Yes | Timestamp of the last sync that observed this node. |
| created_on | Timestamp when Bitbucket created the workspace. | |
| is_private | Whether the workspace is private. | |
| link_html | URL for viewing the workspace in Bitbucket. | |
| name | Yes | Display name of the workspace. |
| slug | Yes | URL-friendly workspace identifier. |
Relationships
(:BitbucketWorkspace)-[:RESOURCE]->(:BitbucketProject): Sub-resource relationship from BitbucketProject to BitbucketWorkspace, used for cleanup scoping.(:BitbucketWorkspace)-[:RESOURCE]->(:BitbucketRepository): Sub-resource relationship from BitbucketRepository to BitbucketWorkspace. Repositories always belong to a workspace, even without a project, so the workspace is the cleanup-scoping root.(:BitbucketWorkspace)-[:RESOURCE]->(:BitbucketUser): Sub-resource relationship from BitbucketUser to BitbucketWorkspace, used for cleanup scoping.