Writable

The writable option controls whether an attribute can be set during create or update requests.

WARNING

Only attributes backed by a database column can be writable. Virtual attributes (methods) cannot be written.

Basic Usage

attribute :title, writable: true        # Writable on create AND update
attribute :title, writable: false       # Read-only (default)

Context-Specific Writing

Control which actions allow writing:

attribute :bio, writable: :create       # Only on create
attribute :verified, writable: :update  # Only on update
attribute :name, writable: true         # Both create and update

Generated Payload Types

Apiwork generates separate types for create and update based on writable declarations:

class AuthorRepresentation < Apiwork::Representation::Base
  attribute :name, writable: true
  attribute :bio, writable: :create
  attribute :verified, writable: :update
end

Create payload — includes name and bio:

export interface AuthorCreatePayload {
  name: string;
  bio?: string;
}

Update payload — includes name and verified:

export interface AuthorUpdatePayload {
  name?: string;
  verified?: boolean;
}

The actual request shape (how payloads are shaped) depends on the adapter. See the adapter documentation for details.

TIP

The Standard Adapter wraps writable attributes under the resource key in the request body.

Examples

• Value Transforms — Transform values during serialization and handle nil/empty conversion