Skip to content

docs(media): a media's visibility now follows its project's - #368

Merged
gregberge merged 1 commit into
mainfrom
greg/arg-501-media-visibility-should-respect-project-by-default
Aug 14, 2026
Merged

gregberge merged 1 commit into
mainfrom
greg/arg-501-media-visibility-should-respect-project-by-default

Conversation

@gregberge

Copy link
Copy Markdown
Member

Part of ARG-501. Companion to argos-ci/argos#2487, which makes the change.

The server now infers a media's default visibility from its project — public project, public media; private project, team-only — instead of from the plan. This updates everything on the client side that described the old rule.

What changed

  • CLI — --visibility help text on media upload.
  • SDK — UploadMediaParameters.visibility JSDoc in @argos-ci/core.
  • Skill — skills/argos-upload/SKILL.md, including the part an agent needs to know: re-uploading keeps the visibility a media already has unless the upload passes --visibility itself.
  • Mock — a comment on the msw handler's ?? "team", which stands in for a server default that no longer exists as a single value.

No behavior change here: the flag and the option already passed null through when omitted, and the server picks the default.

About packages/api-client/src/schema.ts

Untouched on purpose. It is generated from the deployed OpenAPI document (openapi-typescript https://api.argos-ci.com/v2/openapi.yaml), so it picks up the new visibility description on the next build-schema-types run after the API ships. The TypeScript types themselves do not change — visibility stays ("team" | "public") | null.

Testing

@argos-ci/cli and @argos-ci/core type-check, lint and test clean.

🤖 Generated with Claude Code

The server infers the default from the project — public project, public media;
private project, team-only — so the CLI flag, the SDK option and the upload
skill no longer describe it as the most private option the plan allows.

`packages/api-client/src/schema.ts` is generated from the deployed OpenAPI
document, so it picks up the new wording on the next `build-schema-types` run
after the API ships.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@linear-code

linear-code Bot commented Aug 14, 2026

Copy link
Copy Markdown

ARG-501

@vercel

vercel Bot commented Aug 14, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
argos-js-sdk-reference Ready Ready Preview Aug 14, 2026 7:35pm

Request Review

@gregberge
gregberge merged commit d99f82a into main Aug 14, 2026
70 checks passed
@gregberge
gregberge deleted the greg/arg-501-media-visibility-should-respect-project-by-default branch August 14, 2026 19:39

This branch was successfully deployed

1 active deployment
Preview — 30aba668 Deployed Aug 14, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants