{"id":45950394,"url":"https://github.com/basecamp/basecamp-sdk","last_synced_at":"2026-04-02T13:57:06.182Z","repository":{"id":341149758,"uuid":"1142030712","full_name":"basecamp/basecamp-sdk","owner":"basecamp","description":"Basecamp software dev kit","archived":false,"fork":false,"pushed_at":"2026-03-26T04:51:09.000Z","size":3896,"stargazers_count":14,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-26T20:41:43.590Z","etag":null,"topics":["basecamp"],"latest_commit_sha":null,"homepage":"https://basecamp.com/sdk","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/basecamp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-25T20:54:57.000Z","updated_at":"2026-03-26T12:20:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/basecamp/basecamp-sdk","commit_stats":null,"previous_names":["basecamp/basecamp-sdk"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/basecamp/basecamp-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basecamp%2Fbasecamp-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basecamp%2Fbasecamp-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basecamp%2Fbasecamp-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basecamp%2Fbasecamp-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/basecamp","download_url":"https://codeload.github.com/basecamp/basecamp-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basecamp%2Fbasecamp-sdk/sbom","scorecard":{"id":1245021,"data":{"date":"2026-03-19T05:02:32Z","repo":{"name":"github.com/basecamp/basecamp-sdk","commit":"1c33ce43c305f86fa580c716183f1e654a858291"},"scorecard":{"version":"v5.3.0","commit":"c22063e786c11f9dd714d777a687ff7c4599b600"},"score":6.3,"checks":[{"name":"Maintained","score":0,"reason":"project was created within the last 90 days. Please review its contents carefully","details":["Warn: Repository was created within the last 90 days."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#maintained"}},{"name":"Code-Review","score":1,"reason":"Found 5/27 approved changesets -- score normalized to 1","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dangerous-workflow"}},{"name":"Dependency-Update-Tool","score":10,"reason":"update tool detected","details":["Info: detected update tool: Dependabot: .github/dependabot.yml:1"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dependency-update-tool"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Info: Found linked content: SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#security-policy"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'models' permission set to 'read': .github/workflows/ai-labeler.yml:26","Info: jobLevel 'contents' permission set to 'read': .github/workflows/ai-labeler.yml:24","Info: jobLevel 'models' permission set to 'read': .github/workflows/ai-labeler.yml:57","Info: jobLevel 'contents' permission set to 'read': .github/workflows/ai-labeler.yml:55","Info: jobLevel 'contents' permission set to 'read': .github/workflows/direct-push-alert.yml:15","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/release-go.yml:74","Info: jobLevel 'contents' permission set to 'read': .github/workflows/scorecard.yml:18","Info: jobLevel 'contents' permission set to 'read': .github/workflows/sensitive-change-gate.yml:15","Info: topLevel 'contents' permission set to 'read': .github/workflows/ai-labeler.yml:12","Info: topLevel 'models' permission set to 'read': .github/workflows/ai-labeler.yml:14","Info: topLevel 'contents' permission set to 'read': .github/workflows/codeql.yml:12","Info: topLevel 'pull-requests' permission set to 'read': .github/workflows/codeql.yml:13","Warn: topLevel 'security-events' permission set to 'write': .github/workflows/codeql.yml:14","Warn: topLevel 'contents' permission set to 'write': .github/workflows/dependabot-auto-merge.yml:6","Info: topLevel 'contents' permission set to 'read': .github/workflows/direct-push-alert.yml:8","Info: topLevel 'contents' permission set to 'read': .github/workflows/labeler.yml:8","Warn: topLevel 'contents' permission set to 'write': .github/workflows/release-github.yml:14","Info: topLevel 'actions' permission set to 'read': .github/workflows/release-github.yml:15","Info: topLevel 'contents' permission set to 'read': .github/workflows/release-go.yml:10","Info: topLevel 'contents' permission set to 'read': .github/workflows/release-kotlin.yml:10","Warn: topLevel 'packages' permission set to 'write': .github/workflows/release-kotlin.yml:11","Info: topLevel 'contents' permission set to 'read': .github/workflows/release-ruby.yml:10","Info: topLevel 'contents' permission set to 'read': .github/workflows/release-swift.yml:10","Info: topLevel 'contents' permission set to 'read': .github/workflows/release-typescript.yml:10","Info: topLevel permissions set to 'read-all': .github/workflows/scorecard.yml:10","Info: topLevel 'contents' permission set to 'read': .github/workflows/security.yml:13","Warn: topLevel 'security-events' permission set to 'write': .github/workflows/security.yml:14","Info: topLevel 'contents' permission set to 'read': .github/workflows/sensitive-change-gate.yml:8","Info: topLevel 'contents' permission set to 'read': .github/workflows/smithy-verify.yml:7","Warn: no topLevel permission defined: .github/workflows/test.yml:1"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":8,"reason":"binaries present in source code","details":["Warn: binary detected: kotlin/gradle/wrapper/gradle-wrapper.jar:1","Warn: binary detected: spec/smithy-bare-arrays/gradle/wrapper/gradle-wrapper.jar:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":9,"reason":"dependency not pinned by hash detected -- score normalized to 9","details":["Warn: npmCommand not pinned by hash: scripts/bump-version.sh:58","Warn: npmCommand not pinned by hash: .github/workflows/release-typescript.yml:81","Warn: goCommand not pinned by hash: .github/workflows/security.yml:87","Info:  70 out of  70 GitHub-owned GitHubAction dependencies pinned","Info:  26 out of  26 third-party GitHubAction dependencies pinned","Info:   6 out of   8 npmCommand dependencies pinned","Info:   2 out of   3 goCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#cii-best-practices"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":10,"reason":"SAST tool is run on all commits","details":["Info: SAST configuration detected: CodeQL","Info: SAST configuration detected: CodeQL","Info: all commits (28) are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#sast"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#signed-releases"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#fuzzing"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/release-kotlin.yml:56"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#packaging"}},{"name":"Branch-Protection","score":3,"reason":"branch protection is not maximal on development and all release branches","details":["Info: 'allow deletion' disabled on branch 'main'","Info: 'force pushes' disabled on branch 'main'","Warn: 'branch protection settings apply to administrators' is disabled on branch 'main'","Warn: could not determine whether codeowners review is allowed","Warn: 'up-to-date branches' is disabled on branch 'main'","Info: status check found to merge onto on branch 'main'","Warn: PRs are not required to make changes on branch 'main'; or we don't have data to detect it.If you think it might be the latter, make sure to run Scorecard with a PAT or use Repo Rules (that are always public) instead of Branch Protection settings"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#branch-protection"}},{"name":"Contributors","score":10,"reason":"project has 6 contributing companies or organizations","details":["Info: found contributions from: basecamp, hotwired, rack, rails, rbenv, turbolinks"],"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#contributors"}},{"name":"CI-Tests","score":10,"reason":"28 out of 28 merged PRs checked by a CI test -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#ci-tests"}}]},"last_synced_at":"2026-03-19T06:18:44.761Z","repository_id":341149758,"created_at":"2026-03-19T06:18:44.761Z","updated_at":"2026-03-19T06:18:44.761Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31002722,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-26T18:07:05.776Z","status":"ssl_error","status_checked_at":"2026-03-26T18:07:05.331Z","response_time":114,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["basecamp"],"created_at":"2026-02-28T12:27:06.862Z","updated_at":"2026-04-02T13:57:06.170Z","avatar_url":"https://github.com/basecamp.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"assets/basecamp-badge.svg\" height=\"28\" alt=\"Basecamp\"\u003e Basecamp SDK\n\nOfficial [Basecamp](https://basecamp.com) [API](https://github.com/basecamp/bc3-api) clients, runtimes, and software development kits for Go, Ruby, TypeScript, Swift, Kotlin, and Python.\n\nOpenAPI 3.1 spec included.\n\n## Languages\n\n| Language | Path | Status | Package |\n|----------|------|--------|---------|\n| [Go](go/) | `go/` | Active | `github.com/basecamp/basecamp-sdk/go` |\n| [Ruby](ruby/) | `ruby/` | Active | `basecamp-sdk` |\n| [TypeScript](typescript/) | `typescript/` | Active | `@37signals/basecamp` |\n| [Swift](swift/) | `swift/` | Active | `Basecamp` (SPM) |\n| [Kotlin](kotlin/) | `kotlin/` | Active | `com.basecamp:basecamp-sdk` (GitHub Packages) |\n| [Python](python/) | `python/` | Active | `basecamp-sdk` (PyPI) |\n\n| Feature | Go | TypeScript | Ruby | Swift | Kotlin | Python |\n|---------|:--:|:----------:|:----:|:-----:|:------:|:------:|\n| OAuth 2.0 Authentication | ✓ | ✓ | ✓ | ✗ | ✓ | ✓ |\n| Static Token Authentication | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |\n| ETag HTTP Caching (opt-in) | ✓ | ✓ | via Faraday† | ✓ | ✓ | ✗ |\n| Automatic Retry with Backoff | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |\n| Pagination Handling | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |\n| Observability Hooks | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |\n| Structured Errors | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |\n| Webhook Verification | ✓ | ✓ | ✓ | ✗ | ✓ | ✓ |\n\n† Ruby SDK uses Faraday - add caching via [faraday-http-cache](https://github.com/sourcelevel/faraday-http-cache)\n\n**Note:** HTTP caching is disabled by default. Enable explicitly via configuration:\n- **Go:** `cfg.CacheEnabled = true` or `BASECAMP_CACHE_ENABLED=true`\n- **TypeScript:** `enableCache: true` in client options\n- **Swift:** `BasecampConfig(enableCache: true)`\n- **Kotlin:** `enableCache = true` in builder DSL\n\nAll SDKs are generated from a single [Smithy](https://smithy.io/) specification, ensuring consistent behavior and API coverage across languages.\n\n## Quick Start\n\n### Go\n\n```go\npackage main\n\nimport (\n    \"context\"\n    \"fmt\"\n    \"os\"\n\n    \"github.com/basecamp/basecamp-sdk/go/pkg/basecamp\"\n)\n\nfunc main() {\n    cfg := basecamp.DefaultConfig()\n    token := \u0026basecamp.StaticTokenProvider{Token: os.Getenv(\"BASECAMP_TOKEN\")}\n    client := basecamp.NewClient(cfg, token)\n\n    account := client.ForAccount(os.Getenv(\"BASECAMP_ACCOUNT_ID\"))\n    result, err := account.Projects().List(context.Background(), nil)\n    if err != nil {\n        fmt.Fprintf(os.Stderr, \"Error: %v\\n\", err)\n        os.Exit(1)\n    }\n\n    for _, p := range result.Projects {\n        fmt.Printf(\"%d: %s\\n\", p.ID, p.Name)\n    }\n}\n```\n\n### Ruby\n\n```ruby\nrequire \"basecamp\"\n\nclient = Basecamp.client(access_token: ENV[\"BASECAMP_TOKEN\"])\naccount = client.for_account(ENV[\"BASECAMP_ACCOUNT_ID\"])\n\naccount.projects.list.each do |project|\n  puts \"#{project['id']}: #{project['name']}\"\nend\n```\n\n### TypeScript\n\n```typescript\nimport { createBasecampClient } from \"@37signals/basecamp\";\n\nconst client = createBasecampClient({\n  accountId: process.env.BASECAMP_ACCOUNT_ID!,\n  accessToken: process.env.BASECAMP_TOKEN!,\n});\n\nconst projects = await client.projects.list();\nprojects.forEach(p =\u003e console.log(`${p.id}: ${p.name}`));\n```\n\n### Swift\n\n```swift\nimport Basecamp\n\nlet client = BasecampClient(\n    accessToken: ProcessInfo.processInfo.environment[\"BASECAMP_TOKEN\"]!,\n    userAgent: \"my-app/1.0 (you@example.com)\"\n)\n\nlet account = client.forAccount(ProcessInfo.processInfo.environment[\"BASECAMP_ACCOUNT_ID\"]!)\nlet projects = try await account.projects.list()\nfor project in projects {\n    print(\"\\(project.id): \\(project.name)\")\n}\n```\n\n### Kotlin\n\n```kotlin\nval client = BasecampClient {\n    accessToken(System.getenv(\"BASECAMP_TOKEN\"))\n    userAgent = \"my-app/1.0 (you@example.com)\"\n}\n\nval account = client.forAccount(System.getenv(\"BASECAMP_ACCOUNT_ID\"))\nval projects = account.projects.list()\nprojects.forEach { println(\"${it.id}: ${it.name}\") }\n```\n\n### Python\n\n```python\nimport os\nfrom basecamp import Client\n\nclient = Client(access_token=os.environ[\"BASECAMP_TOKEN\"])\naccount = client.for_account(os.environ[\"BASECAMP_ACCOUNT_ID\"])\n\nprojects = account.projects.list()\nfor project in projects:\n    print(f\"{project['id']}: {project['name']}\")\n```\n\n## Features\n\nAll SDKs provide:\n\n- **Full API coverage** - 35+ services covering projects, todos, messages, schedules, campfires, card tables, and more\n- **OAuth 2.0 authentication** - Token refresh, PKCE support (Go, TypeScript, Ruby, Kotlin, Python), and static token options\n- **Automatic retry** - Exponential backoff with jitter, respects `Retry-After` headers\n- **Pagination** - Link header–based pagination support (high-level handling may vary by SDK; see language docs)\n- **ETag caching** - Built-in HTTP caching for efficient API usage (Go, TypeScript, Ruby†, Swift, Kotlin)\n- **Structured errors** - Typed errors with helpful hints and CLI-friendly exit codes\n- **Observability hooks** - Integration points for logging, metrics, and tracing\n\n## API Coverage\n\n| Category | Services |\n|----------|----------|\n| **Projects** | Projects, Templates, Tools, People |\n| **To-dos** | Todos, Todolists, Todosets, TodolistGroups |\n| **Messages** | Messages, MessageBoards, MessageTypes, Comments |\n| **Chat** | Campfires (lines, chatbots) |\n| **Scheduling** | Schedules, Timeline, Lineup, Checkins |\n| **Files** | Vaults, Documents, Uploads, Attachments |\n| **Card Tables** | CardTables, Cards, CardColumns, CardSteps |\n| **Client Portal** | ClientApprovals, ClientCorrespondences, ClientReplies |\n| **Automation** | Webhooks, Subscriptions, Events |\n| **Reporting** | Search, Reports, Timesheets, Recordings |\n\n## Specification\n\nThe [`spec/`](spec/) directory contains the API specification in [Smithy IDL](https://smithy.io/) format. This specification drives:\n\n- OpenAPI generation for client codegen\n- Type definitions across all SDKs\n- Consistent behavior modeling (pagination, retries, idempotency)\n\nSee the [spec README](spec/README.md) for details on the model structure.\n\n## Documentation\n\n- [Go SDK documentation](go/README.md) - Full API reference with examples\n- [Ruby SDK documentation](ruby/README.md) - Gem usage and configuration\n- [TypeScript SDK documentation](typescript/README.md) - npm package usage\n- [Swift SDK documentation](swift/README.md) - SPM package with async/await\n- [Kotlin SDK documentation](kotlin/README.md) - Gradle package with coroutines\n- [Python SDK documentation](python/README.md) - PyPI package with sync and async support\n- [Contributing guide](CONTRIBUTING.md) - Development setup and guidelines\n- [Security policy](SECURITY.md) - Reporting vulnerabilities\n\n## Environment Variables\n\nAll SDKs support common environment variables:\n\n| Variable | Description |\n|----------|-------------|\n| `BASECAMP_TOKEN` | OAuth access token |\n| `BASECAMP_ACCOUNT_ID` | Basecamp account ID |\n| `BASECAMP_BASE_URL` | API base URL (default: `https://3.basecampapi.com`) |\n\nSee individual SDK documentation for language-specific options.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbasecamp%2Fbasecamp-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbasecamp%2Fbasecamp-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbasecamp%2Fbasecamp-sdk/lists"}